通过

IoWMIDeviceObjectToInstanceName 函数 (wdm.h)

  • 项目

IoWMIDeviceObjectToInstanceName 例程确定由设备对象指定的驱动程序实现的 WMI 类实例的实例名称。

语法

NTSTATUS IoWMIDeviceObjectToInstanceName(
  [in]  PVOID           DataBlockObject,
  [in]  PDEVICE_OBJECT  DeviceObject,
  [out] PUNICODE_STRING InstanceName
);

参数

[in] DataBlockObject

指向 WMI 数据块对象的指针。 调用方使用 IoWMIOpenBlock 打开 WMI 类的数据块对象。

[in] DeviceObject

指定设备对象。 例程返回对应于设备对象的驱动程序的实例名称。

[out] InstanceName

指向例程用于返回实例名称 的UNICODE_STRING 结构的指针。 调用方释放 UNICODE_STRING内返回的缓冲区。

返回值

例程返回 NTSTATUS 代码。 可能的返回值包括：

返回代码 说明
STATUS_SUCCESS
 操作成功。 例程将实例名称存储在 InstanceName 参数指定的UNICODE_STRING中。
STATUS_WMI_INSTANCE_NOT_FOUND
 驱动程序不实现 DataBlockObject 指定的 WMI 类的任何实例。

要求

要求 值
最低受支持的客户端 在 Windows XP 和更高版本的 Windows 操作系统中可用。
目标平台 通用
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另请参阅

DEVICE_OBJECT

IoWMIHandleToInstanceName

IoWMIOpenBlock