IWMDMDeviceControl::Record 方法 (mswmdm.h)

Record 方法从设备的外部记录输入开始在当前搜寻位置进行录制。 必须先调用 IWMDMDeviceControl::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 参数提供参数,以指定用于录制的音频格式。 若要确定设备支持的格式,请参阅 GetFormatSupport。 如果 pFormat 参数设置为 NULL,则设备会以默认格式记录音频数据。

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

要求

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

另请参阅

IWMDMDevice::GetFormatSupport

IWMDMDeviceControl 接口

IWMDMDeviceControl::GetCapabilities

IWMDMDeviceControl::Seek

IWMDMObjectInfo 接口

_WAVEFORMATEX