IoWMIDeviceObjectToProviderId function

The IoWMIDeviceObjectToProviderId routine translates the specified device object into the corresponding WMI Provider ID.

Syntax

NTKERNELAPI ULONG IoWMIDeviceObjectToProviderId(
  PDEVICE_OBJECT DeviceObject
);

Parameters

DeviceObject

Pointer to a device object.

Return Value

IoWMIDeviceObjectToProviderId returns the WMI Provider ID associated with the specified device object.

Remarks

IoWMIDeviceObjectToProviderId should be used when filling in the ProviderId member of the WNODE_HEADER structure in those cases when the WNODEHEADER structure is being initialized as part of a WNODE_EVENT_ITEM or WNODE_EVENT_REFERENCE structure. (If the WNODE_HEADER is being used for other purposes, ProviderId is reserved.)

When running on a 32-bit operating system, the provider ID and the device object are identical. When running on a 64-bit operating system, IoWMIDeviceObjectToProviderId will convert the 64-bit device object to a 32-bit provider ID.

Requirements

   
Windows version Available starting with Windows 2000.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL "<= DISPATCH_LEVEL"

See Also

WNODE_EVENT_ITEM

WNODE_EVENT_REFERENCE

WNODE_HEADER