IoInvalidateDeviceState function (wdm.h)

Article
02/22/2024

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

Syntax

void IoInvalidateDeviceState(
  [in] PDEVICE_OBJECT PhysicalDeviceObject
);

Parameters

[in] 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

Requirement	Value
Minimum supported client	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