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 |