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 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.