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	指定裝置的符號連結。