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

Статья
02/07/2025

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

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

Синтаксис

PGET_DEVICE_INFORMATION PgetDeviceInformation;

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

Параметры

[in] _context

Указывает значение контекста из контекста члена HDAUDIO_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 (include Hdaudio.h)
IRQL	PASSIVE_LEVEL

См. также

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_V2

HDAUDIO_DEVICE_INFORMATION

Поделиться через