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 |