オーディオまたはビデオキャプチャデバイスの一覧を列挙します。
構文
パラメーター
pAttributes [in]
検索条件を含む属性ストアへのポインタ。属性ストアを作成するには、 MFCreateAttributesを呼び出します。次の属性の1つまたは複数の属性を設定します。
pppSourceActivate [out]
IMFActivateインターフェイス ポインターの配列を受け取ります。各ポインタは、メディアソースのアクティベーションオブジェクトを表します。関数がメモリの配列を割り当てます。呼び出し元は、配列のポインターを解放し、配列のメモリを解放するために CoTaskMemFreeを呼び出す必要があります。
pcSourceActivate [out]
pppSourceActivate配列の要素数を受け取ります。検索条件に一致するキャプチャデバイスがない場合は、このパラメーターは値 0 を受け取ります。
戻り値
成功したら、S_OKを、それ以外の場合はHRESULTのエラーコードを返す。
解説
返されたそれぞれのIMFActivateポインターはキャプチャデバイスを表します、またそれらはデバイスのメディアソースを作成するために使用されます。
デバイスを記述した属性クエリのIMFActivateポインターを使用することもできます。次の属性が設定する可能性があります。
メディア ソースをIMFActivateポインターを作成するには、 IMFActivate::ActivateObjectメソッドを呼び出します。
構文
HRESULT MFEnumDeviceSources( __in IMFAttributes *pAttributes, __out IMFActivate ***pppSourceActivate, __out UINT32 *pcSourceActivate );
パラメーター
pAttributes [in]
検索条件を含む属性ストアへのポインタ。属性ストアを作成するには、 MFCreateAttributesを呼び出します。次の属性の1つまたは複数の属性を設定します。
値 | 意味 |
---|---|
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE | オーディオまたはビデオ デバイスを列挙するかどうかを指定します。(必須) |
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE | オーディオ キャプチャ デバイスは、デバイスの役割を指定します。(省略可能) |
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_CATEGORY | ビデオ キャプチャ デバイスは、デバイスのカテゴリを指定します。(省略可能) |
IMFActivateインターフェイス ポインターの配列を受け取ります。各ポインタは、メディアソースのアクティベーションオブジェクトを表します。関数がメモリの配列を割り当てます。呼び出し元は、配列のポインターを解放し、配列のメモリを解放するために CoTaskMemFreeを呼び出す必要があります。
pcSourceActivate [out]
pppSourceActivate配列の要素数を受け取ります。検索条件に一致するキャプチャデバイスがない場合は、このパラメーターは値 0 を受け取ります。
戻り値
成功したら、S_OKを、それ以外の場合はHRESULTのエラーコードを返す。
解説
返されたそれぞれのIMFActivateポインターはキャプチャデバイスを表します、またそれらはデバイスのメディアソースを作成するために使用されます。
デバイスを記述した属性クエリのIMFActivateポインターを使用することもできます。次の属性が設定する可能性があります。
属性 | 説明 |
---|---|
MF_DEVSOURCE_ATTRIBUTE_FRIENDLY_NAME | デバイスの表示名 |
MF_DEVSOURCE_ATTRIBUTE_MEDIA_TYPE | デバイスの出力形式について説明する主要なタイプとサブタイプ Guid |
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE | キャプチャデバイス (オーディオまたはビデオデバイス) |
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID | オーディオ エンドポイント ID 文字列(オーディオ デバイスのみ) |
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_CATEGORY | デバイスのカテゴリ(ビデオデバイスのみ) |
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_HW_SOURCE | デバイスがハードウェアまたはソフトウェア デバイスかどうか(ビデオ デバイスのみ) |
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK | デバイスドライバー用のシンボリック リンク。(ビデオ デバイスのみ) |
メディア ソースをIMFActivateポインターを作成するには、 IMFActivate::ActivateObjectメソッドを呼び出します。
最新コメント