Compartilhar via

Propriedades do ponto de extremidade de áudio

  • Artigo

O arquivo de cabeçalho Mmdeviceapi.h define várias propriedades de dispositivos de ponto de extremidade de áudio no Windows Vista e posterior. O serviço de áudio do Windows define os valores dessas propriedades. Os clientes podem ler essas propriedades, mas não devem defini-las. Os valores de propriedade são armazenados como estruturas PROPVARIANT .

A maneira recomendada de ler as propriedades de um dispositivo de entrada de áudio é usar as APIs no namespace Windows.Devices.Enumeration. Essas APIs têm suporte para aplicativos da Windows Store e aplicativos da área de trabalho. Para aplicativos de área de trabalho existentes que leem as propriedades do dispositivo usando a interface IMMDevice, consulte Propriedades do dispositivo. O IMMDevice não tem suporte para aplicativos da Windows Store.

Para obter exemplos de código que mostram como acessar as propriedades de um dispositivo de ponto de extremidade de áudio, consulte os seguintes tópicos:

Para obter informações sobre PROPVARIANT, consulte a documentação do SDK do Windows.

As propriedades a seguir são específicas para dispositivos de ponto de extremidade de áudio.

Propriedade Descrição
PKEY_AudioEndpoint_Association Associa uma categoria de pino kernel-streaming (KS) a um dispositivo de ponto de extremidade de áudio.
PKEY_AudioEndpoint_ControlPanelPageProvider Especifica o CLSID do provedor registrado da extensão device-properties para o dispositivo de ponto de extremidade de áudio.
PKEY_AudioEndpoint_Disable_SysFx Indica se os efeitos do sistema estão habilitados no fluxo de modo compartilhado que flui de ou para o dispositivo de ponto de extremidade de áudio.
PKEY_AudioEndpoint_FormFactor Indica os atributos físicos do dispositivo de ponto de extremidade de áudio.
PKEY_AudioEndpoint_FullRangeSpeakers Especifica a máscara de configuração de canal para os alto-falantes de alcance total conectados ao dispositivo de ponto de extremidade de áudio.
PKEY_AudioEndpoint_GUID Fornece o identificador de dispositivo DirectSound que corresponde ao dispositivo de ponto de extremidade de áudio.
PKEY_AudioEndpoint_PhysicalSpeakers Define a configuração do alto-falante físico para o dispositivo de ponto de extremidade de áudio.
PKEY_AudioEngine_DeviceFormat Especifica o formato do dispositivo, que é o formato que o mecanismo de áudio usa para o fluxo de modo compartilhado que flui de ou para o dispositivo de ponto de extremidade de áudio.
PKEY_AudioEngine_OEMFormat Especifica o formato padrão do dispositivo usado para renderizar ou capturar um fluxo. Os valores são preenchidos pelo OEM em um arquivo .inf.
PKEY_AudioEndpoint_Supports_EventDriven_Mode Indica se o ponto de extremidade oferece suporte ao modo controlado por evento. Os valores são preenchidos pelo OEM em um arquivo .inf.
PKEY_AudioEndpoint_JackSubType Contém um GUID de categoria de saída para um dispositivo de ponto de extremidade de áudio.

As APIs de áudio principais oferecem suporte a propriedades adicionais que não se aplicam exclusivamente a dispositivos de ponto de extremidade de áudio. Para obter mais informações sobre essas propriedades adicionais, consulte Propriedades do dispositivo.

Dispositivos de ponto de extremidade de áudio

Referência de programação