Compartilhar via


Função IoInvalidateDeviceState (wdm.h)

A rotina IoInvalidateDeviceState do 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 para o dispositivo.

Valor de retorno

Nenhum

Observações

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 PnP envia uma solicitação IRP_MN_QUERY_PNP_DEVICE_STATE para a pilha de dispositivos, para determinar o estado PnP atual do dispositivo.

Requisitos

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

Consulte também

IRP_MN_QUERY_PNP_DEVICE_STATE

PNP_DEVICE_STATE