Compartilhar via


PKEY_AudioEndpoint_GUID

A propriedade PKEY_AudioEndpoint_GUID fornece o identificador de dispositivo DirectSound que corresponde ao dispositivo de ponto de extremidade de áudio. O valor da propriedade é um GUID que o cliente pode fornecer como o identificador de dispositivo para a função DirectSoundCreate ou DirectSoundCaptureCreate na API DirectSound. Esse valor identifica exclusivamente o dispositivo de ponto de extremidade de áudio em todos os dispositivos de ponto de extremidade de áudio no sistema. Para obter mais informações sobre o DirectSound, consulte a documentação do SDK do DirectX.

O membro vt da estrutura PROPVARIANT é definido como VT_LPWSTR.

O membro pwszVal da estrutura PROPVARIANT aponta para uma cadeia de caracteres largos terminada em nulo que contém um GUID que identifica o dispositivo de ponto de extremidade de áudio no DirectSound.

Conforme explicado anteriormente, a API MMDevice dá suporte a funções de dispositivo. Embora o DirectSound não dê suporte diretamente a funções de dispositivo, um cliente DirectSound pode usar a propriedade PKEY_AudioEndpoint_GUID para selecionar um dispositivo de renderização ou captura directSound com base em sua função de dispositivo.

Por exemplo, um aplicativo DirectSound executa as seguintes etapas para criar um dispositivo DirectSound que corresponde ao dispositivo de ponto de extremidade de renderização ao qual o usuário atribuiu a função eMultimedia:

  1. Chame o método IMMDeviceEnumerator::GetDefaultAudioEndpoint para obter a interface IMMDevice do dispositivo de ponto de extremidade de renderização que tem a função eMultimedia.
  2. Chame o método IMMDevice::OpenPropertyStore para obter a interface IPropertyStore do dispositivo eMultimedia. Para obter mais informações sobre o IPropertyStore, consulte a documentação do SDK do Windows.
  3. Chame o método IPropertyStore::GetValue para obter o valor da propriedade PKEY_AudioEndpoint_GUID.
  4. Converta o valor da propriedade de um GUID no formato de cadeia de caracteres em uma estrutura GUID de 16 bytes.
  5. Chame a função DirectSoundCreate com o GUID para criar o dispositivo com a função eMultimedia.

Observação

PKEY_AudioEndpoint_GUID é uma propriedade somente leitura, independentemente do modo de acesso de armazenamento solicitado pelo aplicativo em IMMDevice::OpenPropertyStore. Se um aplicativo tentar definir um valor usando IPropertyStore::SetValue, essa chamada falhará com o código de erro E_ACCESSDENIED.

 

Observe que o GUID de 16 bytes gerado na etapa 4 corresponde ao GUID do dispositivo que identifica o dispositivo durante a enumeração do dispositivo DirectSound. A função DirectSoundEnumerate enumera a renderização de dispositivos de ponto de extremidade e a função DirectSoundCaptureEnumerate enumera dispositivos de ponto de extremidade de captura. Em ambos os casos, o GUID do dispositivo é o primeiro parâmetro passado para a função de retorno de chamada de enumeração. Para obter mais informações sobre a enumeração DirectSound, consulte a documentação do SDK do DirectX.

Para obter um exemplo de código que usa a propriedade PKEY_AudioEndpoint_GUID, consulte Funções de dispositivo para aplicativos DirectSound.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho
Mmdeviceapi.h

Confira também

Propriedades do ponto de extremidade de áudio

Principais propriedades de áudio