PKEY_AudioEndpoint_GUID

La propiedad PKEY_AudioEndpoint_GUID proporciona el identificador de dispositivo DirectSound que corresponde al dispositivo de punto de conexión de audio. El valor de la propiedad es un GUID que el cliente puede proporcionar como identificador de dispositivo a la función DirectSoundCreate o DirectSoundCaptureCreate en directSound API. Este valor identifica de forma única el dispositivo de punto de conexión de audio en todos los dispositivos de punto de conexión de audio del sistema. Para obtener más información sobre DirectSound, consulte la documentación del SDK de DirectX.

El miembro vt de la estructura PROPVARIANT se establece en VT_LPWSTR.

El miembro pwszVal de la estructura PROPVARIANT apunta a una cadena de caracteres anchos terminada en null que contiene un GUID que identifica el dispositivo de punto de conexión de audio en DirectSound.

Como se explicó anteriormente, la API MMDevice admite roles de dispositivo. Aunque DirectSound no admite directamente roles de dispositivo, un cliente de DirectSound puede usar la propiedad PKEY_AudioEndpoint_GUID para seleccionar un dispositivo de representación o captura de DirectSound en función de su rol de dispositivo.

Por ejemplo, una aplicación directSound realiza los pasos siguientes para crear un dispositivo DirectSound que corresponda al dispositivo de punto de conexión de representación al que el usuario ha asignado el rol eMultimedia:

1. Llame al método IMMDeviceEnumerator::GetDefaultAudioEndpoint para obtener la interfaz IMMDevice del dispositivo de extremo de representación que tiene el rol eMultimedia.
2. Llame al método IMMDevice::OpenPropertyStore para obtener la interfaz IPropertyStore del dispositivo eMultimedia. Para obtener más información sobre IPropertyStore, consulte la documentación de Windows SDK.
3. Llame al método IPropertyStore::GetValue para obtener el valor de la propiedad PKEY_AudioEndpoint_GUID.
4. Convierta el valor de propiedad de un GUID en formato de cadena a una estructura GUID de 16 bytes.
5. Llame a la función DirectSoundCreate con el GUID para crear el dispositivo con el rol eMultimedia.

Nota

PKEY_AudioEndpoint_GUID es una propiedad de solo lectura independientemente del modo de acceso de almacenamiento solicitado por la aplicación en IMMDevice::OpenPropertyStore. Si una aplicación intenta establecer un valor mediante IPropertyStore::SetValue, se produce un error en esta llamada con el código de error E_ACCESSDENIED.

 

Tenga en cuenta que el GUID de 16 bytes generado en el paso 4 coincide con el GUID del dispositivo que identifica el dispositivo durante la enumeración de dispositivos de DirectSound. La función DirectSoundEnumerate enumera los dispositivos de punto de conexión de representación y la función DirectSoundCaptureEnumerate enumera los dispositivos de punto de conexión de captura. En cualquier caso, el GUID del dispositivo es el primer parámetro pasado a la función de devolución de llamada de enumeración. Para obtener más información sobre la enumeración directSound, consulte la documentación del SDK de DirectX.

Para obtener un ejemplo de código que usa la propiedad PKEY_AudioEndpoint_GUID, consulte Roles de dispositivo para aplicaciones directSound.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Mmdeviceapi.h

Consulte también

Propiedades del punto de conexión de audio

Propiedades principales de audio