MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE属性
オーディオ レンダラーのオーディオ エンドポイント ロールを指定します。
データ型
UINT32
注釈
この属性を使用して、オーディオ レンダラーを構成できます。 使用は、オーディオ レンダラーを作成するために呼び出す関数によって異なります。
- MFCreateAudioRenderer: pAudioAttributes パラメーターで指定された IMFAttributes インターフェイス ポインターを使用して、この属性 を 設定します。
- MFCreateAudioRendererActivate: ppActivate パラメーターで取得した IMFActivate インターフェイス ポインターを使用して、この属性を設定します。 IMFActivate::ActivateObject を呼び出す前に、 属性を設定します。
オーディオ エンドポイント デバイスは、ヘッドホンやスピーカーなどのオーディオ データ パスの一方の端にあるハードウェア デバイスです。
この属性が設定されている場合、オーディオ レンダラーは、指定されたロールに既定のオーディオ デバイスを使用します。 この属性の値は、ヘッダー ファイル mmdeviceapi.h で定義されている ERole 列挙体のメンバーです。 詳細については、Core Audio API のドキュメントを参照してください。 この属性が設定されていない場合、オーディオ レンダラーは既定のエンドポイント デバイスを使用します。
この属性が設定されている場合は、 MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID 属性を設定しないでください。 両方の属性が設定されている場合、オーディオ レンダラーの作成時にエラーが発生します。
この属性の GUID 定数は、mfuuid.lib からエクスポートされます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |
| Header |
|
こちらもご覧ください