共用方式為


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

另請參閱

啟用物件

媒體基礎中的音訊/視訊擷取

擷取裝置屬性

MFCreateDeviceSource

媒體基礎函式