Filtro del representador de DirectSound
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
Este filtro representa el audio mediante DirectSound. Este filtro es actualmente el representador de audio predeterminado para el sonido de forma de onda.
Además de sus funcionalidades básicas de representación de sonido, este filtro puede procesar llamadas API de DirectSound. Use los métodos IAMDirectSound para establecer y recuperar la ventana que controlará la reproducción de sonido. DirectSound Audio Renderer es el filtro de representación de audio predeterminado para DirectShow.
| Etiqueta | Value |
|---|---|
| Interfaces de filtro | IAMAudioRendererStats, IAMClockSlave, IAMDirectSound, IAMResourceControl, IBaseFilter, IBasicAudio, IDirectSound3DBuffer, IDirectSound3dListener, IMediaPosition, IMediaSeeking, IQualityControl, IReferenceClock |
| Tipos de medios de patillas de entrada | Tipo principal: MEDIATYPE_AudioSubtypes:
|
| Interfaces de patillas de entrada | IMemInputPin, IPin, IPinConnection, IQualityControl |
| Tipos de medios de anclaje de salida | No es aplicable. |
| Interfaces de pin de salida | No es aplicable. |
| Filtrar CLSID | CLSID_DSoundRender |
| CLSID de página de propiedades | CLSID_AudioProperties, CLSID_AudioRendererAdvancedProperties |
| Ejecutable | quartz.dll |
| Mérito | MERIT_PREFERRED |
| Categoría de filtro | CLSID_AudioRendererCategory |
Observaciones
Este filtro actúa como contenedor para un dispositivo de audio. Para enumerar los dispositivos de audio disponibles en el sistema del usuario, use la interfaz ICreateDevEnum con la categoría de representador de audio (CLSID_AudioRendererCategory). Para cada dispositivo de audio, la categoría del representador de audio contiene dos instancias de filtro. Uno de estos corresponde al representador de DirectSound y el otro corresponde al filtro De representador de audio (WaveOut). La instancia de DirectSound tiene el nombre descriptivo "DirectSound: DeviceName", donde DeviceName es el nombre del dispositivo. La instancia de WaveOut tiene el nombre descriptivo DeviceName.
La categoría del representador de audio contiene dos instancias de filtro adicionales, denominadas "Default DirectSound Device" y "Default WaveOut Device". Estos corresponden al dispositivo de sonido predeterminado, según lo elegido por el usuario a través de la Panel de control. En realidad, se asignan a uno de los pares descritos en el párrafo anterior. Por ejemplo, si el sistema tiene dos dispositivos de audio, Dispositivo A y Dispositivo B, la categoría del representador de audio contendrá lo siguiente:
- Dispositivo A
- DirectSound: dispositivo A
- Dispositivo B
- DirectSound: dispositivo B
- Dispositivo DirectSound predeterminado
- Dispositivo WaveOut predeterminado
Si el usuario seleccionó Device A como dispositivo predeterminado, "Default DirectSound Device" es equivalente a "DirectSound: Device A" y "Default WaveOut Device" es equivalente a "Device A". Si el usuario selecciona El dispositivo B como dispositivo predeterminado, estas asignaciones cambiarán.
"Dispositivo DirectSound predeterminado" tiene asignado un mérito de MERIT_PREFERRED. Los demás tienen mérito MERIT_DO_NOT_USE. Por lo tanto, Intelligent Connect siempre elegirá el dispositivo DirectSound predeterminado.
El filtro DirectSound Renderer admite sonido 3D a través de las interfaces DirectSound IDirectSound3DBuffer e IDirectSound3dListener . También puede consultar el filtro para las versiones actuales de estas interfaces, IDirectSound3DBuffer8 e IDirectSound3dListener8. Ejecute el gráfico antes de llamar a métodos en estas interfaces.