通过

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

[in, out] DeviceInformation

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

返回值

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

返回代码 描述
STATUS_BUFFER_TOO_SMALL
 指示在 deviceInformation 缓冲区开头指定的大小太小。

言论

此例程检索静态设备相关信息，即信息不会随时间而动态更改。

deviceInformation 参数是指向缓冲区的指针，该缓冲区包含一个HDAUDIO_DEVICE_INFORMATION结构，例程将有关 HD 音频控制器的信息写入其中。 在调用 GetDeviceInformation之前，调用方将缓冲区的大小（以字节为单位）写入缓冲区的 大小 成员中。

要求

要求 价值
目标平台 桌面
标头 hdaudio.h （包括 Hdaudio.h）
IRQL PASSIVE_LEVEL

另请参阅

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_V2

HDAUDIO_DEVICE_INFORMATION