// wdm.h
NTSTATUS IoWMIDeviceObjectToInstanceName(
[in] PVOID DataBlockObject,
[in] PDEVICE_OBJECT DeviceObject,
[out] PUNICODE_STRING InstanceName
);
View the official Windows Driver Kit DDI referenceNo description available.
The IoWMIDeviceObjectToInstanceName routine determines the instance name for the WMI class instance implemented by the driver that is specified by a device object.
DataBlockObject [in]Pointer to a WMI data block object. The caller opens the data block object for the WMI class with IoWMIOpenBlock.
DeviceObject [in]Specifies a device object. The routine returns the instance name for the driver corresponding to the device object.
InstanceName [out]Pointer to the UNICODE_STRING structure that the routine uses to return the instance name. The caller frees the returned buffer within UNICODE_STRING.
The routine returns an NTSTATUS code. Possible return values include:
| Return code | Description |
|---|---|
| STATUS_SUCCESS | The operation succeeded. The routine stores the instance name in the UNICODE_STRING specified by the InstanceName parameter. |
| STATUS_WMI_INSTANCE_NOT_FOUND | The driver does not implement any instances of the WMI class specified by DataBlockObject. |