ioWMIQuerySingleInstance 函数 (wdm.h)
IoWMIQuerySingleInstance 例程返回 WMI 数据块的指定实例。
语法
NTSTATUS IoWMIQuerySingleInstance(
[in] PVOID DataBlockObject,
[in] PUNICODE_STRING InstanceName,
[in, out] PULONG InOutBufferSize,
[out, optional] PVOID OutBuffer
);
参数
[in] DataBlockObject
指向 WMI 数据块对象的指针。 调用方使用 IoWMIOpenBlock 例程打开 WMI 类的数据块对象。 必须使用WMIGUID_QUERY访问权限打开对象。
[in] InstanceName
指定数据块实例的名称。 此值对应于 块的 InstanceName 属性的值。
[in, out] InOutBufferSize
指向内存位置的指针，该位置指定 在 OutBuffer 参数中传递的缓冲区的大小。 如果例程成功，它将更新内存位置以指定 OutBuffer 中实际存储的字节数。 如果例程失败，状态代码为 STATUS_BUFFER_TOO_SMALL，它将返回返回数据所需的字节数。
[out, optional] OutBuffer
指向缓冲区的指针，例程在其中返回 WMI 数据。 例程返回大小可变 的WNODE_SINGLE_INSTANCE 结构。 OutBuffer 必须指向从非分页池分配的缓冲区。
返回值
例程返回 NTSTATUS 代码。 可能的返回值包括：
| 返回代码 | 说明 |
|---|---|
|
操作成功。 例程返回 OutBuffer 参数指向的缓冲区中的 WMI 数据。 该例程还返回 InOutBufferSize 参数指向的内存位置中返回的数据的大小（以字节为单位）。 |
|
没有驱动程序实现指定的 WMI 类。 |
|
没有驱动程序实现的 WMI 类实例，其 InstanceName 属性等于 InstanceName 参数中指定的值。 |
|
调用方在 OutBuffer 参数中传递的缓冲区太小。 例程返回 InOutBufferSize 参数指向的内存位置中所需的缓冲区大小。 |
注解
IoWMIQuerySingleInstance 确定哪些驱动程序可能支持具有指定实例名称的指定 WMI 类，并为每个此类驱动程序发出 IRP_MN_QUERY_SINGLE_INSTANCE 请求。 导出具有匹配 InstanceName 属性的数据块实例的驱动程序返回相应的数据。
若要查询多个 WMI 类和实例名称，请使用 IoWMIQuerySingleInstanceMultiple 例程。 驱动程序可以使用 IoWMISetSingleInstance 例程来更新类实例。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows XP 和更高版本的 Windows 操作系统中可用。 |
| 目标平台 | 通用 |
| 标头 | wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h） |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |