Share via

Filtro renderer DirectSound

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Questo filtro esegue il rendering dell'audio usando DirectSound. Questo filtro è attualmente il renderer audio predefinito per il suono waveform.

Oltre alle funzionalità di rendering audio di base, questo filtro può elaborare chiamate API DirectSound. Usare i metodi IAMDirectSound per impostare e recuperare la finestra che gestirà la riproduzione del suono. DirectSound Audio Renderer è il filtro di rendering audio predefinito per DirectShow.

Etichetta Valore
Interfacce di filtro IAMAudioRendererStats, IAMClockSlave, IAMDirectSound, IAMResourceControl, IBaseFilter, IBasicAudio, IDirectSound3DBuffer, IDirectSound3dListener, IMediaPosition, IMediaSeeking, IQualityControl, IReferenceClock
Tipi di supporti pin di input Tipo principale: MEDIATYPE_AudioSubtypes:
  • MEDIASUBTYPE_PCM
  • MEDIASUBTYPE_IEEE_FLOAT
  • MEDIASUBTYPE_DOLBY_AC3_SPDIF
  • MEDIASUBTYPE_RAW_SPORT
  • MEDIASUBTYPE_SPDIF_TAG_241h
  • MEDIASUBTYPE_DRM_Audio
Tipo di formato: FORMAT_WaveFormatEx
Interfacce pin di input IMemInputPin, IPin, IPinConnection, IQualityControl
Tipi di supporti di pin di output Non applicabile.
Interfacce pin di output Non applicabile.
Filtro CLSID CLSID_DSoundRender
Pagina delle proprietà CLSID CLSID_AudioProperties, CLSID_AudioRendererAdvancedProperties
File eseguibile quartz.dll
Merito MERIT_PREFERRED
Categoria filtro CLSID_AudioRendererCategory

Commenti

Questo filtro funge da wrapper per un dispositivo audio. Per enumerare i dispositivi audio disponibili nel sistema dell'utente, usare l'interfaccia ICreateDevEnum con la categoria del renderer audio (CLSID_AudioRendererCategory). Per ogni dispositivo audio, la categoria del renderer audio contiene due istanze di filtro. Uno di questi corrisponde al renderer DirectSound e l'altro corrisponde al filtro Audio Renderer (WaveOut). L'istanza DirectSound ha il nome descrittivo "DirectSound: DeviceName", dove DeviceName è il nome del dispositivo. L'istanza di WaveOut ha il nome descrittivo DeviceName.

La categoria del renderer audio contiene due istanze di filtro aggiuntive, denominate "Default DirectSound Device" e "Default WaveOut Device". Questi corrispondono al dispositivo audio predefinito, come scelto dall'utente tramite il Pannello di controllo. Vengono effettivamente mappati a una delle coppie descritte nel paragrafo precedente. Ad esempio, se il sistema ha due dispositivi audio, Device A e Device B, la categoria del renderer audio conterrà quanto segue:

  • Dispositivo A
  • DirectSound: Dispositivo A
  • Dispositivo B
  • DirectSound: Dispositivo B
  • Dispositivo DirectSound predefinito
  • Dispositivo WaveOut predefinito

Se l'utente ha selezionato Device A come dispositivo predefinito, "Default DirectSound Device" equivale a "DirectSound: Device A" e "Default WaveOut Device" equivale a "Device A". Se l'utente seleziona Device B come dispositivo predefinito, questi mapping verranno modificati.

"Default DirectSound Device" viene assegnato un merito di MERIT_PREFERRED. Gli altri hanno merito MERIT_DO_NOT_USE. Di conseguenza, Intelligent Connect sceglierà sempre il dispositivo DirectSound predefinito.

Il filtro Renderer DirectSound supporta l'audio 3D tramite le interfacce DirectSound IDirectSound3DBuffer e IDirectSound3dListener . È anche possibile eseguire query sul filtro per le versioni correnti di queste interfacce, IDirectSound3DBuffer8 e IDirectSound3dListener8. Eseguire il grafico prima di chiamare i metodi in queste interfacce.

Filtri DirectShow