Função IoInvalidateDeviceState (wdm.h)

A rotina IoInvalidateDeviceState notifica o gerenciador PnP de que algum aspecto do estado PnP de um dispositivo foi alterado.

Sintaxe

void IoInvalidateDeviceState(
  [in] PDEVICE_OBJECT PhysicalDeviceObject
);

Parâmetros

[in] PhysicalDeviceObject

Ponteiro para o PDO do dispositivo.

Retornar valor

Nenhum

Comentários

Os drivers chamam essa rotina para indicar que algo mudou em relação a um dos seguintes aspectos do estado PnP de um dispositivo:

PNP_DEVICE_DISABLED

PNP_DEVICE_DONT_DISPLAY_IN_UI

PNP_DEVICE_FAILED

PNP_DEVICE_NOT_DISABLEABLE

PNP_DEVICE_REMOVED

PNP_DEVICE_RESOURCE_REQUIREMENTS_CHANGED

Para obter descrições das constantes anteriores, consulte PNP_DEVICE_STATE.

Em resposta a essa rotina, o gerenciador de PnP envia uma solicitação IRP_MN_QUERY_PNP_DEVICE_STATE para a pilha do dispositivo, para determinar o estado PnP atual do dispositivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 2000.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Confira também

IRP_MN_QUERY_PNP_DEVICE_STATE

PNP_DEVICE_STATE