Filtre du renderer DirectSound
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
Ce filtre restitue l’audio à l’aide de DirectSound. Ce filtre est actuellement le convertisseur audio par défaut pour le son de forme d’onde.
En plus de ses fonctionnalités de rendu audio de base, ce filtre peut traiter les appels d’API DirectSound. Utilisez les méthodes IAMDirectSound pour définir et récupérer la fenêtre qui gérera la lecture du son. Le convertisseur audio DirectSound est le filtre de rendu audio par défaut pour DirectShow.
| Étiquette | Valeur |
|---|---|
| Interfaces de filtre | IAMAudioRendererStats, IAMClockSlave, IAMDirectSound, IAMResourceControl, IBaseFilter, IBasicAudio, IDirectSound3DBuffer, IDirectSound3dListener, IMediaPosition, IMediaSeeking, IQualityControl, IReferenceClock |
| Types de supports de broche d’entrée | Type principal : MEDIATYPE_AudioSubtypes :
|
| Interfaces de broche d’entrée | IMemInputPin, IPin, IPinConnection, IQualityControl |
| Types de supports de broche de sortie | Non applicable. |
| Interfaces de broche de sortie | Non applicable. |
| Filtrer le CLSID | CLSID_DSoundRender |
| CLSID page de propriétés | CLSID_AudioProperties, CLSID_AudioRendererAdvancedProperties |
| Exécutable | quartz.dll |
| Mérite | MERIT_PREFERRED |
| Catégorie de filtre | CLSID_AudioRendererCategory |
Notes
Ce filtre joue le rôle de wrapper pour un périphérique audio. Pour énumérer les périphériques audio disponibles sur le système de l’utilisateur, utilisez l’interface ICreateDevEnum avec la catégorie de convertisseur audio (CLSID_AudioRendererCategory). Pour chaque périphérique audio, la catégorie de convertisseur audio contient deux instances de filtre. L’une d’elles correspond au convertisseur DirectSound et l’autre au filtre Convertisseur audio (WaveOut). Le instance DirectSound porte le nom convivial « DirectSound : DeviceName », où DeviceName est le nom de l’appareil. Le instance WaveOut porte le nom convivial DeviceName.
La catégorie du convertisseur audio contient deux instances de filtre supplémentaires, nommées « Appareil DirectSound par défaut » et « Appareil WaveOut par défaut ». Celles-ci correspondent au périphérique audio par défaut, tel que choisi par l’utilisateur via le Panneau de configuration. Il s’agit en fait de mappages à l’une des paires décrites dans le paragraphe précédent. Par exemple, si le système a deux périphériques audio, l’appareil A et l’appareil B, la catégorie de convertisseur audio contient les éléments suivants :
- Appareil A
- DirectSound : Appareil A
- Appareil B
- DirectSound : Appareil B
- Appareil DirectSound par défaut
- Appareil WaveOut par défaut
Si l’utilisateur a sélectionné l’appareil A comme appareil par défaut, « Appareil DirectSound par défaut » équivaut à « DirectSound : Appareil A » et « Appareil WaveOut par défaut » équivaut à « Appareil A ». Si l’utilisateur sélectionne l’appareil B comme appareil par défaut, ces mappages changent.
« Appareil DirectSound par défaut » se voit attribuer un mérite de MERIT_PREFERRED. Les autres ont le mérite MERIT_DO_NOT_USE. Par conséquent, Intelligent Connect choisit toujours l’appareil DirectSound par défaut.
Le filtre DirectSound Renderer prend en charge le son 3D via les interfaces DirectSound IDirectSound3DBuffer et IDirectSound3dListener . Vous pouvez également interroger le filtre pour les versions actuelles de ces interfaces, IDirectSound3DBuffer8 et IDirectSound3dListener8. Exécutez le graphique avant d’appeler des méthodes sur ces interfaces.