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 属性を設定する必要があります。

オーディオキャプチャデバイスの場合は、必要に応じて次のいずれかの属性を設定します。

属性	説明
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 ロールの既定のオーディオキャプチャデバイスを選択します。

ビデオキャプチャデバイスの場合は、次の属性を設定する必要があります。

属性	説明
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK	デバイスへのシンボリックリンクを指定します。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	mfidl.h
Library	Mf.lib
[DLL]	Mf.dll