Filtro do Renderizador DirectSound
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEnginee Audio/Video Capture na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
Esse filtro renderiza o áudio usando DirectSound. Atualmente, esse filtro é o renderizador de áudio padrão para o som de forma de onda.
Além de seus recursos básicos de renderização de som, esse filtro pode processar chamadas à API DirectSound. Use os métodos IAMDirectSound para definir e recuperar a janela que manipulará a reprodução de som. O Renderizador de Áudio DirectSound é o filtro de renderização de áudio padrão para DirectShow.
| Etiqueta | Valor |
|---|---|
| Interfaces de filtro | IAMAudioRendererStats, IAMClockSlave, IAMDirectSound, IAMResourceControl, IBaseFilter, IBasicAudio, IDirectSound3DBuffer, IDirectSound3dListener, IMediaPosition, IMediaSeeking, IQualityControl, IReferenceClock |
| Tipos de mídia de pino de entrada | Tipo principal: MEDIATYPE_AudioSubtypes:
|
| Interfaces de pin de entrada | IMemInputPin, IPin, IPinConnection, IQualityControl |
| Tipos de mídia de pino de saída | Não aplicável. |
| Interfaces de pino de saída | Não aplicável. |
| Filtrar CLSID | CLSID_DSoundRender |
| CLSID da página de propriedades | CLSID_AudioProperties, CLSID_AudioRendererAdvancedProperties |
| Executável | quartz.dll |
| de Mérito | MERIT_PREFERRED |
| de categoria de filtro de | CLSID_AudioRendererCategory |
Observações
Esse filtro atua como um wrapper para um dispositivo de áudio. Para enumerar os dispositivos de áudio disponíveis no sistema do usuário, use a interfaceICreateDevEnumcom a categoria de renderizador de áudio (CLSID_AudioRendererCategory). Para cada dispositivo de áudio, a categoria do renderizador de áudio contém duas instâncias de filtro. Um deles corresponde ao Renderizador DirectSound e o outro corresponde ao filtro Renderizador de Áudio (WaveOut). A instância do DirectSound tem o nome amigável "DirectSound: DeviceName", em que DeviceName é o nome do dispositivo. A instância do WaveOut tem o nome amigável DeviceName.
A categoria do renderizador de áudio contém duas instâncias de filtro adicionais, chamadas "Dispositivo DirectSound Padrão" e "Dispositivo WaveOut Padrão". Elas correspondem ao dispositivo de som padrão, conforme escolhido pelo usuário por meio do Painel de Controle. Na verdade, são mapeamentos para um dos pares descritos no parágrafo anterior. Por exemplo, se o sistema tiver dois dispositivos de áudio, Dispositivo A e Dispositivo B, a categoria do renderizador de áudio conterá o seguinte:
- Dispositivo A
- DirectSound: Dispositivo A
- Dispositivo B
- DirectSound: Dispositivo B
- Dispositivo DirectSound padrão
- Dispositivo WaveOut padrão
Se o usuário selecionou o Dispositivo A como o dispositivo padrão, "Dispositivo DirectSound Padrão" é equivalente a "DirectSound: Dispositivo A" e "Dispositivo WaveOut Padrão" é equivalente a "Dispositivo A". Se o usuário selecionar o Dispositivo B como o dispositivo padrão, esses mapeamentos serão alterados.
"Dispositivo DirectSound padrão" recebe um mérito de MERIT_PREFERRED. Os outros têm mérito MERIT_DO_NOT_USE. Portanto, o Intelligent Connect sempre escolherá o dispositivo DirectSound padrão.
O filtro Do Renderizador DirectSound dá suporte ao som 3D por meio das interfaces IDirectSound3DBuffer DirectSound3DBuffer e IDirectSound3dListener. Você também pode consultar o filtro para as versões atuais dessas interfaces, IDirectSound3DBuffer8 e IDirectSound3dListener8. Execute o grafo antes de chamar métodos nessas interfaces.