IMDSPDeviceControl::Record 方法 (mswmdm.h)

Record 方法从设备的外部记录输入开始在当前搜寻位置进行录制。 必须首先调用 Seek 方法。

语法

HRESULT Record(
  [in] _WAVEFORMATEX *pFormat
);

参数

[in] pFormat

指向 _WAVEFORMATEX 结构的指针,该结构包含必须记录数据的格式。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。
E_BUSY
设备已在执行操作。
WMDM_E_NOTSUPPORTED
记录函数未在此设备上实现。
E_FAIL
发生了未指定的错误。

注解

此方法用于调用设备录制 (录制要存储在媒体设备上的音频轨道) ,以及从要在计算机上录制的媒体设备流式传输音频数据。 Seek 方法确定发生哪种形式的记录。

某些设备不支持任一类型的录制。 在开始录制之前,必须调用 GetCapabilities 方法。 如果尝试不受支持的录制类型,此方法将返回WMDM_E_NOTSUPPORTED。

可以提供 pFormat 参数的参数来指定用于录制的音频数据格式。 若要确定设备支持的格式,请参阅 IMDSPDevice::GetFormatSupport。 如果 pFormat 参数设置为 NULL,则设备以默认格式记录音频数据。

使用设备录制时,必须枚举存储介质内容,以在记录操作完成后查找新对象。

要求

要求
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

另请参阅

IMDSPDevice::GetFormatSupport

IMDSPDeviceControl 接口

IMDSPDeviceControl::GetCapabilities

IMDSPDeviceControl::Seek

_WAVEFORMATEX