IoWMIDeviceObjectToInstanceName function (wdm.h)
The IoWMIDeviceObjectToInstanceName routine determines the instance name for the WMI class instance implemented by the driver that is specified by a device object.
Syntax
NTSTATUS IoWMIDeviceObjectToInstanceName(
[in] PVOID DataBlockObject,
[in] PDEVICE_OBJECT DeviceObject,
[out] PUNICODE_STRING InstanceName
);
Parameters
[in] DataBlockObject
Pointer to a WMI data block object. The caller opens the data block object for the WMI class with IoWMIOpenBlock.
[in] DeviceObject
Specifies a device object. The routine returns the instance name for the driver corresponding to the device object.
[out] InstanceName
Pointer to the UNICODE_STRING structure that the routine uses to return the instance name. The caller frees the returned buffer within UNICODE_STRING.
Return value
The routine returns an NTSTATUS code. Possible return values include:
Return code | Description |
---|---|
|
The operation succeeded. The routine stores the instance name in the UNICODE_STRING specified by the InstanceName parameter. |
|
The driver does not implement any instances of the WMI class specified by DataBlockObject. |
Requirements
Requirement | Value |
---|---|
Minimum supported client | Available in Windows XP and later versions of the Windows operating system. |
Target Platform | Universal |
Header | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |