Filtro renderer DirectSound
[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:
|
| 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.