Partager via


Utilitaires Speaker-Configuration propriétaires

Note Ces informations s’appliquent à Windows XP et aux systèmes d’exploitation antérieurs. À compter de Windows Vista, IDirectSound::GetSpeakerConfig et IDirectSound::SetSpeakerConfig ont été déconseillés.

Les fournisseurs de matériel fournissent parfois des utilitaires propriétaires de configuration du haut-parleur à utiliser avec leurs pilotes audio à la place de la boîte de dialogue haut-parleur dans Panneau de configuration. Ces utilitaires ont un problème potentiel : ils modifient parfois la configuration de l’orateur d’une manière propriétaire qui ne parvient pas à notifier Windows de la modification. Cela peut entraîner une mauvaise expérience utilisateur si les paramètres de l’utilitaire propriétaire ne correspondent pas à ceux de Panneau de configuration. Si vous pensez que votre appareil nécessite un utilitaire propriétaire, vous devez effectuer les étapes suivantes pour intégrer votre utilitaire à Windows :

  1. Implémentez un nœud DAC dans votre pilote qui prend en charge la propriété KSPROPERTY_AUDIO_CHANNEL_CONFIG . Via ce nœud, Windows informe immédiatement le pilote des modifications apportées par l’utilisateur dans Panneau de configuration.

  2. Concevez votre utilitaire de configuration pour gérer la configuration de l’orateur en appelant les méthodes DirectSound GetSpeakerConfig et SetSpeakerConfig.

L’appel SetSpeakerConfig informe DirectSound (et Windows) des modifications apportées par votre utilitaire à la configuration de l’orateur. En outre, le code d’initialisation de votre utilitaire doit appeler GetSpeakerConfig pour déterminer si l’utilisateur a modifié des paramètres via Panneau de configuration. Dans ce cas, l’utilitaire doit refléter ces modifications dans son interface utilisateur.

Si votre appareil prend en charge les formats multicanaux qui n’ont pas d’équivalents Windows précis, votre utilitaire de configuration doit effectuer les opérations suivantes :

  • Lorsque vous passez à une configuration de haut-parleur qui n’a pas d’équivalent Windows précis, appelez SetSpeakerConfig avec l’équivalent Windows le plus proche. Cela s’ajoute aux appels propriétaires nécessaires à la configuration du pilote.

  • Lorsque vous passez à une configuration de haut-parleur qui a un équivalent Windows précis, appelez SetSpeakerConfig pour mettre à jour le mode haut-parleur.

Si vous rendez Windows plus conscient des fonctionnalités de votre appareil, DirectSound peut activer certaines fonctionnalités qu’il ne pourrait pas activer autrement (par exemple, le panoramique 3D multicanal).