DirectSound-Rendererfilter
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Dieser Filter rendert Audio mithilfe von DirectSound. Dieser Filter ist derzeit der Standard-Audiorenderer für Wellenformsound.
Zusätzlich zu den grundlegenden Funktionen des Soundrenderings kann dieser Filter DirectSound-API-Aufrufe verarbeiten. Verwenden Sie die IAMDirectSound-Methoden , um das Fenster festzulegen und abzurufen, das die Soundwiedergabe behandelt. DirectSound Audio Renderer ist der Standard-Audiorenderingfilter für DirectShow.
Bezeichnung | Wert |
---|---|
Filterschnittstellen | IAMAudioRendererStats, IAMClockSlave, IAMDirectSound, IAMResourceControl, IBaseFilter, IBasicAudio, IDirectSound3DBuffer, IDirectSound3dListener, IMediaPosition, IMediaSeeking, IQualityControl, IReferenceClock |
Eingabeheftmedientypen | Haupttyp: MEDIATYPE_AudioSubtypes:
|
Eingabenadelschnittstellen | IMemInputPin, IPin, IPinConnection, IQualityControl |
Ausgabeheftmedientypen | Nicht zutreffend |
Ausgabepinschnittstellen | Nicht zutreffend |
CLSID filtern | CLSID_DSoundRender |
Eigenschaftenseite CLSID | CLSID_AudioProperties, CLSID_AudioRendererAdvancedProperties |
Ausführbare Datei | quartz.dll |
Verdienst | MERIT_PREFERRED |
Filterkategorie | CLSID_AudioRendererCategory |
Bemerkungen
Dieser Filter fungiert als Wrapper für ein Audiogerät. Um die im System des Benutzers verfügbaren Audiogeräte aufzulisten, verwenden Sie die ICreateDevEnum-Schnittstelle mit der Kategorie Audiorenderer (CLSID_AudioRendererCategory). Für jedes Audiogerät enthält die Audiorenderer-Kategorie zwei Filterinstanzen. Eine davon entspricht dem DirectSound-Renderer, der andere dem Filter Audiorenderer (WaveOut). Die DirectSound-instance hat den Anzeigenamen "DirectSound: DeviceName", wobei DeviceName der Name des Geräts ist. Die WaveOut-instance hat den Anzeigenamen DeviceName.
Die Audiorendererkategorie enthält zwei zusätzliche Filterinstanzen mit dem Namen "Default DirectSound Device" und "Default WaveOut Device". Diese entsprechen dem Standard-Soundgerät, das vom Benutzer über die Systemsteuerung ausgewählt wird. Sie sind tatsächlich einem der Paare zugeordnet, die im vorherigen Absatz beschrieben wurden. Wenn das System beispielsweise über zwei Audiogeräte verfügt: Gerät A und Gerät B, enthält die Kategorie Audiorenderer Folgendes:
- Gerät A
- DirectSound: Gerät A
- Gerät B
- DirectSound: Gerät B
- DirectSound-Standardgerät
- WaveOut-Standardgerät
Wenn der Benutzer Gerät A als Standardgerät ausgewählt hat, entspricht "DirectSound-Standardgerät" "DirectSound: Gerät A", und "WaveOut-Standardgerät" entspricht "Gerät A". Wenn der Benutzer Gerät B als Standardgerät auswählt, ändern sich diese Zuordnungen.
Dem "DirectSound-Standardgerät" wird MERIT_PREFERRED zugewiesen. Die anderen haben Verdienste MERIT_DO_NOT_USE. Daher wählt Intelligent Connect immer das DirectSound-Standardgerät aus.
Der DirectSound Renderer-Filter unterstützt 3D-Sound über die Schnittstellen DirectSound IDirectSound3DBuffer und IDirectSound3dListener . Sie können den Filter auch für die aktuellen Versionen dieser Schnittstellen abfragen, IDirectSound3DBuffer8 und IDirectSound3dListener8. Führen Sie das Diagramm aus, bevor Sie Methoden für diese Schnittstellen aufrufen.
Zugehörige Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für