IoInvalidateDeviceState function

The IoInvalidateDeviceState routine notifies the PnP manager that some aspect of the PnP state of a device has changed.

Syntax

NTKERNELAPI VOID IoInvalidateDeviceState(
  PDEVICE_OBJECT PhysicalDeviceObject
);

Parameters

PhysicalDeviceObject

Pointer to the PDO for the device.

Return Value

None

Remarks

Drivers call this routine to indicate that something has changed with respect to one of the following aspects of a device's PnP state:

PNP_DEVICE_DISABLED

PNP_DEVICE_DONT_DISPLAY_IN_UI

PNP_DEVICE_FAILED

PNP_DEVICE_NOT_DISABLEABLE

PNP_DEVICE_REMOVED

PNP_DEVICE_RESOURCE_REQUIREMENTS_CHANGED

For descriptions of the preceding constants, see PNP_DEVICE_STATE.

In response to this routine, the PnP manager sends an IRP_MN_QUERY_PNP_DEVICE_STATE request to the device stack, to determine the current PnP state of the device.

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

IRP_MN_QUERY_PNP_DEVICE_STATE

PNP_DEVICE_STATE