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 屬性,這會指定裝置類型 (音訊或視訊) 。
針對音訊擷取裝置,選擇性地設定下列其中一個屬性:
屬性 | Description |
---|---|
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID | 指定音訊擷取裝置的音訊端點標識碼。 |
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE |
指定裝置角色。 如果設定此屬性,函式會針對該裝置角色使用預設音訊擷取裝置。
請勿將此屬性與 MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID 屬性結合。 |
如果未指定任何屬性,函式會選取 eCommunications 角色的預設音訊擷取裝置。
針對視訊擷取裝置,您必須設定下列屬性:
屬性 | Description |
---|---|
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK | 指定裝置的符號連結。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | mfidl.h |
程式庫 | Mf.lib |
Dll | Mf.dll |