MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE属性

オーディオ キャプチャ デバイスのデバイス ロールを指定します。

データ型

UINT32 として格納されている ERole

取得/設定

この属性を取得するには、 IMFAttributes::GetUINT32 を呼び出します。

この属性を設定するには、 IMFAttributes::SetUINT32 を呼び出します。

解説

eRole 列挙型は、Core Audio API のドキュメントに記載されています。

属性の値は、デバイス ロールを指定します。 この属性は、次の関数で使用されます。

この属性は、MFCreateDeviceSource 関数および MFCreateDeviceSourceActivate 関数への入力として使用できます。 属性が指定されている場合、関数は、指定されたデバイス ロールの既定のオーディオ キャプチャ デバイスを使用するメディア ソースを作成します。

この属性は、 MFEnumDeviceSources 関数への入力としても使用できます。 属性が指定されている場合、列挙は指定されたデバイス ロールに制限されます。 さらに、 MFEnumDeviceSources 関数によって返される各アクティブ化オブジェクトには、この属性が含まれています。 その後、この属性は、メディア ソースを作成するときにアクティブ化オブジェクトによって内部的に使用されます。

この属性の GUID 定数は、mfuuid.lib からエクスポートされます。

必要条件

要件
サポートされている最小のクライアント
Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2008 R2 [デスクトップ アプリのみ]
Header
Mfidl.h

関連項目

Media Foundation 属性のアルファベット順リスト

オーディオ/ビデオのキャプチャ

デバイス属性のキャプチャ