Função PoFxUnregisterDevice (wdm.h)

A rotina PoFxUnregisterDevice remove o registro de um dispositivo da PoFx (estrutura de gerenciamento de energia).

Sintaxe

void PoFxUnregisterDevice(
  [in] POHANDLE Handle
);

Parâmetros

[in] Handle

Um identificador que representa o registro do dispositivo com PoFx. O driver do dispositivo recebeu esse identificador anteriormente da rotina PoFxRegisterDevice .

Retornar valor

Nenhum

Comentários

O driver que possui a política de energia de um dispositivo deve cancelar o registro do dispositivo da PoFx quando o dispositivo for removido. O gerenciador de Plug and Play (PnP) pode remover a pilha do dispositivo da árvore PnP somente depois que o dispositivo não for registrado.

Para cancelar o registro do dispositivo, o driver chama PoFxUnregisterDevice durante o tratamento de uma solicitação de IRP_MN_REMOVE_DEVICE ou IRP_MN_SURPRISE_REMOVAL , o que for recebido primeiro. Essa chamada deve ocorrer depois que o driver não exigir mais acesso ao hardware do dispositivo.

Um driver de dispositivo que chama essa rotina deve ter chamado anteriormente a rotina PoFxRegisterDevice para registrar o dispositivo com PoFx.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 8.
Plataforma de Destino	Universal
Cabeçalho	wdm.h
Biblioteca	Ntoskrnl.lib
DLL	Ntoskrnl.exe
IRQL	PASSIVE_LEVEL

Confira também

IRP_MN_REMOVE_DEVICE

IRP_MN_SURPRISE_REMOVAL

PoFxRegisterDevice