DirectSound レンダラー フィルター
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
このフィルターは、DirectSound を使用してオーディオをレンダリングします。 このフィルターは現在、波形サウンドの既定のオーディオ レンダラーです。
このフィルターは、基本的なサウンド レンダリング機能に加えて、DirectSound API 呼び出しを処理できます。 IAMDirectSound メソッドを使用して、サウンドの再生を処理するウィンドウを設定および取得します。 DirectSound オーディオ レンダラーは、DirectShow の既定のオーディオ レンダリング フィルターです。
| Label | 値 |
|---|---|
| フィルター インターフェイス | IAMAudioRendererStats、 IAMClockSlave、 IAMDirectSound、 IAMResourceControl、 IBaseFilter、 IBasicAudio、 IDirectSound3DBuffer、 IDirectSound3dListener、 IMediaPosition、 IMediaSeeking、 IQualityControl、 IReferenceClock |
| 入力ピン メディアの種類 | メジャーの種類: MEDIATYPE_AudioSubtypes:
|
| 入力ピン インターフェイス | IMemInputPin、 IPin、 IPinConnection、 IQualityControl |
| 出力ピン メディアの種類 | 該当なし。 |
| 出力ピン インターフェイス | 該当なし。 |
| CLSID のフィルター処理 | CLSID_DSoundRender |
| プロパティ ページ CLSID | CLSID_AudioProperties、CLSID_AudioRendererAdvancedProperties |
| [実行可能ファイル] | quartz.dll |
| メリット | MERIT_PREFERRED |
| フィルター カテゴリ | CLSID_AudioRendererCategory |
解説
このフィルターは、オーディオ デバイスのラッパーとして機能します。 ユーザーのシステムで使用可能なオーディオ デバイスを列挙するには、 ICreateDevEnum インターフェイスとオーディオ レンダラー カテゴリ (CLSID_AudioRendererCategory) を使用します。 オーディオ デバイスごとに、オーディオ レンダラー カテゴリには 2 つのフィルター インスタンスが含まれます。 これらの 1 つは DirectSound レンダラーに対応し、もう 1 つは オーディオ レンダラー (WaveOut) フィルターに対応しています。 DirectSound インスタンスのフレンドリ名は "DirectSound: DeviceName" で、 DeviceName はデバイスの名前です。 WaveOut インスタンスのフレンドリ名は DeviceName です。
オーディオ レンダラー カテゴリには、"Default DirectSound Device" と "Default WaveOut Device" という名前の 2 つの追加フィルター インスタンスが含まれています。これらは、コントロール パネルを介してユーザーが選択した既定のサウンド デバイスに対応します。 これらは実際には、前の段落で説明したペアのいずれかにマッピングされています。 たとえば、システムにデバイス A とデバイス B という 2 つのオーディオ デバイスがある場合、オーディオ レンダラー カテゴリには次のものが含まれます。
- デバイス A
- DirectSound: デバイス A
- デバイス B
- DirectSound: デバイス B
- 既定の DirectSound デバイス
- 既定の WaveOut デバイス
ユーザーが既定のデバイスとしてデバイス A を選択した場合、"Default DirectSound Device" は "DirectSound: Device A" に相当し、"Default WaveOut Device" は "Device A" と同じです。ユーザーが既定のデバイスとしてデバイス B を選択すると、これらのマッピングが変更されます。
"Default DirectSound Device" には、MERIT_PREFERREDのメリットが割り当てられます。 他の人はMERIT_DO_NOT_USEメリットがあります。 そのため、Intelligent Connect は常に既定の DirectSound デバイスを選択します。
DirectSound レンダラー フィルターは、DirectSound IDirectSound3DBuffer インターフェイスと IDirectSound3dListener インターフェイスを介して 3D サウンドをサポートします。 これらのインターフェイスの現在のバージョンである IDirectSound3DBuffer8 および IDirectSound3dListener8 のフィルターに対してクエリを 実行することもできます。 これらのインターフェイスでメソッドを呼び出す前に、グラフを実行します。