Propriedades do ponto de extremidade de áudio
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 de PROPVARIANT.
A maneira recomendada de ler as propriedades de um dispositivo de entrada de áudio é usar as APIs no namespaceWindows.Devices.Enumeration. Estas APIs são suportadas para aplicações da Loja Windows e aplicações de ambiente de trabalho. Para aplicativos de área de trabalho existentes que leem as propriedades do dispositivo usando a interfaceIMMDevice, consulte Propriedades do dispositivo. IMMDevice não é suportado para aplicações da Loja Windows.
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 de streaming de kernel (KS) a um dispositivo de ponto de extremidade de áudio. |
| PKEY_AudioEndpoint_ControlPanelPageProvider | Especifica o CLSID do provedor registrado da extensão de propriedades do dispositivo 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 completo 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 suporta o modo controlado por eventos. 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 suportam 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.