PKEY_AudioEndpoint_GUID
La propriété PKEY_AudioEndpoint_GUID fournit l’identificateur d’appareil DirectSound qui correspond à l’appareil de point de terminaison audio. La valeur de la propriété est un GUID que le client peut fournir comme identificateur d’appareil à la fonction DirectSoundCreate ou DirectSoundCaptureCreate dans l’API DirectSound. Cette valeur identifie de manière unique l’appareil de point de terminaison audio sur tous les appareils de point de terminaison audio du système. Pour plus d’informations sur DirectSound, consultez la documentation du Kit de développement logiciel (SDK) DirectX.
Le membre vt de la structure PROPVARIANT est défini sur VT_LPWSTR.
Le membre pwszVal de la structure PROPVARIANT pointe vers une chaîne à caractères larges terminée par null qui contient un GUID qui identifie le périphérique de point de terminaison audio dans DirectSound.
Comme expliqué précédemment, l’API MMDevice prend en charge les rôles d’appareil. Bien que DirectSound ne prend pas directement en charge les rôles d’appareil, un client DirectSound peut utiliser la propriété PKEY_AudioEndpoint_GUID pour sélectionner un appareil de rendu ou de capture DirectSound en fonction de son rôle d’appareil.
Par exemple, une application DirectSound effectue les étapes suivantes pour créer un appareil DirectSound qui correspond à l’appareil de point de terminaison de rendu auquel l’utilisateur a attribué le rôle eMultimedia :
- Appelez la méthode IMMDeviceEnumerator::GetDefaultAudioEndpoint pour obtenir l’interface IMMDevice du périphérique de point de terminaison de rendu qui a le rôle eMultimedia.
- Appelez la méthode IMMDevice::OpenPropertyStore pour obtenir l’interface IPropertyStore de l’appareil eMultimedia. Pour plus d’informations sur IPropertyStore, consultez la documentation du Kit de développement logiciel (SDK) Windows.
- Appelez la méthode IPropertyStore::GetValue pour obtenir la valeur de propriété PKEY_AudioEndpoint_GUID.
- Convertissez la valeur de la propriété d’un GUID au format chaîne en une structure GUID de 16 octets.
- Appelez la fonction DirectSoundCreate avec le GUID pour créer l’appareil avec le rôle eMultimedia.
Notes
PKEY_AudioEndpoint_GUID est une propriété en lecture seule, quel que soit le mode d’accès au stockage demandé par l’application dans IMMDevice::OpenPropertyStore. Si une application tente de définir une valeur à l’aide de IPropertyStore::SetValue, cet appel échoue avec le code d’erreur E_ACCESSDENIED.
Notez que le GUID de 16 octets généré à l’étape 4 correspond au GUID de l’appareil qui identifie l’appareil lors de l’énumération de l’appareil DirectSound. La fonction DirectSoundEnumerate énumère les appareils de point de terminaison de rendu, et la fonction DirectSoundCaptureEnumerate énumère les appareils de point de terminaison de capture. Dans les deux cas, le GUID de l’appareil est le premier paramètre passé à la fonction de rappel d’énumération. Pour plus d’informations sur l’énumération DirectSound, consultez la documentation du Kit de développement logiciel (SDK) DirectX.
Pour obtenir un exemple de code qui utilise la propriété PKEY_AudioEndpoint_GUID, consultez Rôles d’appareil pour les applications DirectSound.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2008 [applications de bureau uniquement] |
| En-tête |
|
Voir aussi