PGET_DEVICE_INFORMATION função de retorno de chamada (hdaudio.h)
A rotina de GetDeviceInformation recupera informações sobre o dispositivo do controlador de áudio HD.
O tipo de ponteiro de função para uma rotina de GetDeviceInformation é definido da seguinte maneira.
Sintaxe
PGET_DEVICE_INFORMATION PgetDeviceInformation;
NTSTATUS PgetDeviceInformation(
[in] PVOID _context,
[in, out] PHDAUDIO_DEVICE_INFORMATION DeviceInformation
)
{...}
Parâmetros
[in] _context
Especifica o valor de contexto do Context membro do HDAUDIO_BUS_INTERFACE ou da estrutura HDAUDIO_BUS_INTERFACE_V2.
[in, out] DeviceInformation
Recupera informações sobre o dispositivo do controlador de áudio HD. Esse parâmetro aponta para uma estrutura de HDAUDIO_DEVICE_INFORMATION alocada pelo chamador na qual a rotina grava as informações do dispositivo.
Valor de retorno
GetDeviceInformation retornará STATUS_SUCCESS se a chamada for bem-sucedida. Caso contrário, a rotina retornará um código de erro apropriado. A tabela a seguir mostra um possível código de status de retorno.
| Código de retorno | Descrição |
|---|---|
|
Indica que o tamanho especificado no início do buffer deviceInformation é muito pequeno. |
Observações
Essa rotina recupera informações dependentes do dispositivo que são estáticas, ou seja, as informações não mudam dinamicamente ao longo do tempo.
O parâmetro deviceInformation é um ponteiro para um buffer que contém uma estrutura HDAUDIO_DEVICE_INFORMATION na qual a rotina grava informações sobre o controlador de áudio HD. Antes de chamar GetDeviceInformation, o chamador aloca o buffer e grava o tamanho do buffer em bytes no membro tamanho do no início do buffer.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | hdaudio.h (inclua Hdaudio.h) |
| IRQL | PASSIVE_LEVEL |