PGET_DEVICE_INFORMATION回调函数 (hdaudio.h)

GetDeviceInformation 程检索有关 HD 音频控制器设备的信息。

例程的 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结构的Context 成员的上下文值。

[in, out] DeviceInformation

检索有关 HD 音频控制器设备的信息。 此参数指向调用方分配 HDAUDIO_DEVICE_INFORMATION 结构,例程在其中写入设备信息。

返回值

GetDeviceInformation 如果调用成功,则返回STATUS_SUCCESS。 否则,例程将返回相应的错误代码。 下表显示了可能的返回状态代码。

返回代码 说明
STATUS_BUFFER_TOO_SMALL
指示 deviceInformation 缓冲区开头指定的大小太小。

注解

此例程检索与设备相关的静态信息,即信息不会随时间而动态变化。

deviceInformation 参数是指向缓冲区的指针,该缓冲区包含HDAUDIO_DEVICE_INFORMATION结构,例程将有关 HD 音频控制器的信息写入其中。 调用 GetDeviceInformation之前,调用方分配缓冲区,并将缓冲区的大小(以字节为单位)写入缓冲区开头的 Size 成员。

要求

要求
目标平台 桌面
标头 hdaudio.h (包括 Hdaudio.h)
IRQL PASSIVE_LEVEL

另请参阅

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_V2

HDAUDIO_DEVICE_INFORMATION