Método IAudioEndpointVolume::QueryHardwareSupport (endpointvolume.h)

  • Artigo

O método QueryHardwareSupport consulta o dispositivo de ponto de extremidade de áudio em busca de suas funções com suporte de hardware.

Sintaxe

HRESULT QueryHardwareSupport(
  [out] DWORD *pdwHardwareSupportMask
);

Parâmetros

[out] pdwHardwareSupportMask

Ponteiro para uma variável DWORD na qual o método grava uma máscara de suporte de hardware que indica os recursos de hardware do dispositivo de ponto de extremidade de áudio. O método pode definir a máscara como 0 ou como a combinação OR bit a bit de uma ou mais constantes ENDPOINT_HARDWARE_SUPPORT_XXX .

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
E_POINTER
 O parâmetro pdwHardwareSupportMask é NULL.

Comentários

Esse método indica se o dispositivo de ponto de extremidade de áudio implementa as seguintes funções no hardware:

  • Controle de volume
  • Ativar mudo do controle
  • Medidor de pico
O sistema substitui automaticamente uma implementação de software para qualquer função na lista anterior que o dispositivo de ponto de extremidade não implementa no hardware.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho endpointvolume.h

Confira também

IAudioEndpointVolume Interface