MFCreateDeviceSourceActivate 函数 (mfidl.h)

创建表示硬件捕获设备的激活对象。

语法

HRESULT MFCreateDeviceSourceActivate(
  [in]  IMFAttributes *pAttributes,
  [out] IMFActivate   **ppActivate
);

[in] pAttributes

指向属性存储的 IMFAttributes 接口的指针，该接口用于选择设备。请参阅“备注”。

[out] ppActivate

接收指向 IMFActivate 接口的指针。调用方必须释放接口。

无

此函数创建可用于为硬件设备创建媒体源的激活对象。若要创建媒体源本身，请调用 IMFActivate：：ActivateObject。

pAttributes 参数指定属性存储。若要创建属性存储，请调用 MFCreateAttributes 函数。必须设置 MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE 属性，该属性指定设备类型 (音频或视频) 。

对于音频捕获设备，可以选择设置以下属性之一：

Attribute	说明
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID	指定音频捕获设备的音频终结点 ID。
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE	指定设备角色。如果设置了此属性，函数将使用该设备角色的默认音频捕获设备。请勿将此属性与 MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID 属性组合在一起。

如果未指定这两个属性，则函数会为 eCommunications 角色选择默认音频捕获设备。

对于视频捕获设备，必须设置以下属性：

Attribute	说明
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK	指定到设备的符号链接。