функция обратного вызова PGET_DEVICE_INFORMATION (hdaudio.h)

  • Статья

Подпрограмма GetDeviceInformation извлекает сведения об устройстве контроллера HD Audio.

Тип указателя функции для GetDeviceInformation подпрограммы определяется следующим образом.

Синтаксис

PGET_DEVICE_INFORMATION PgetDeviceInformation;

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

Параметры

[in] _context

Задает значение контекста из элемента ContextHDAUDIO_BUS_INTERFACE или структуры HDAUDIO_BUS_INTERFACE_V2 .

[in, out] DeviceInformation

Извлекает сведения об устройстве контроллера HD Audio. Этот параметр указывает на структуру, выделенную вызывающим объектом HDAUDIO_DEVICE_INFORMATION , в которую подпрограмма записывает сведения об устройстве.

Возвращаемое значение

GetDeviceInformation возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае подпрограмма возвращает соответствующий код ошибки. В следующей таблице показан возможный код состояния возврата.

Код возврата Описание
STATUS_BUFFER_TOO_SMALL
 Указывает, что размер, указанный в начале буфера deviceInformation , слишком мал.

Комментарии

Эта подпрограмма извлекает зависимые от устройства сведения, которые являются статическими, то есть данные не изменяются динамически с течением времени.

Параметр deviceInformation — это указатель на буфер, содержащий структуру HDAUDIO_DEVICE_INFORMATION, в которую подпрограмма записывает сведения о контроллере HD Audio. Перед вызовом GetDeviceInformationвызывающий объект выделяет буфер и записывает размер буфера в байтах в элемент Size в начале буфера.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть hdaudio.h (включая Hdaudio.h)
IRQL PASSIVE_LEVEL

См. также раздел

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_V2

HDAUDIO_DEVICE_INFORMATION