PGET_DEVICE_INFORMATION función de devolución de llamada (hdaudio.h)

Artículo
02/26/2024

La GetDeviceInformation rutina recupera información sobre el dispositivo de controlador de audio HD.

El tipo de puntero de función para una GetDeviceInformation rutina se define de la siguiente manera.

Sintaxis

PGET_DEVICE_INFORMATION PgetDeviceInformation;

NTSTATUS PgetDeviceInformation(
  [in]      PVOID _context,
  [in, out] PHDAUDIO_DEVICE_INFORMATION DeviceInformation
)
{...}

Parámetros

[in] _context

Especifica el valor de contexto del miembro Context del HDAUDIO_BUS_INTERFACE o la estructura HDAUDIO_BUS_INTERFACE_V2 .

[in, out] DeviceInformation

Recupera información sobre el dispositivo de controlador de audio HD. Este parámetro apunta a una estructura de HDAUDIO_DEVICE_INFORMATION asignada por el autor de la llamada en la que la rutina escribe la información del dispositivo.

Valor devuelto

GetDeviceInformation devuelve STATUS_SUCCESS si la llamada se realiza correctamente. De lo contrario, la rutina devuelve un código de error adecuado. En la tabla siguiente se muestra un posible código de estado de retorno.

Código devuelto	Descripción
STATUS_BUFFER_TOO_SMALL	Indica que el tamaño especificado al principio del búfer deviceInformation es demasiado pequeño.

Comentarios

Esta rutina recupera información dependiente del dispositivo que es estática, es decir, la información no cambia dinámicamente con el tiempo.

El parámetro deviceInformation es un puntero a un búfer que contiene una estructura HDAUDIO_DEVICE_INFORMATION en la que la rutina escribe información sobre el controlador de audio HD. Antes de llamar a , el llamador GetDeviceInformationasigna el búfer y escribe el tamaño del búfer en bytes en el miembro Size al principio del búfer.