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。 否则,例程将返回相应的错误代码。 下表显示了可能的返回状态代码。
返回代码 | 说明 |
---|---|
|
指示 deviceInformation 缓冲区开头指定的大小太小。 |
注解
此例程检索与设备相关的静态信息,即信息不会随时间而动态变化。
deviceInformation 参数是指向缓冲区的指针,该缓冲区包含HDAUDIO_DEVICE_INFORMATION结构,例程将有关 HD 音频控制器的信息写入其中。 调用 GetDeviceInformation
之前,调用方分配缓冲区,并将缓冲区的大小(以字节为单位)写入缓冲区开头的 Size 成员。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | hdaudio.h (包括 Hdaudio.h) |
IRQL | PASSIVE_LEVEL |