Função IoUnregisterPlugPlayNotification (wdm.h)
Essa rotina é obsoleta no Windows 7 e versões posteriores do Windows. Para obter mais informações, consulte a seção comentários abaixo.
A rotina de IoUnregisterPlugPlayNotification remove o registro da rotina de retorno de chamada de um driver para um evento PnP.
Sintaxe
NTSTATUS IoUnregisterPlugPlayNotification(
[in] PVOID NotificationEntry
);
Parâmetros
[in] NotificationEntry
Ponteiro para um valor opaco que representa o registro a ser removido. O valor foi retornado por uma chamada anterior para IoRegisterPlugPlayNotification.
Valor de retorno
IoUnregisterPlugPlayNotification sempre retornará STATUS_SUCCESS se notificationEntry for válido.
Observações
No Windows 7 e versões posteriores do Windows, essa função é obsoleta e é fornecida apenas para dar suporte a drivers existentes. Use a rotina de IoUnregisterPlugPlayNotificationEx.
O sistema não sincroniza entre a execução da rotina de notificação e IoUnregisterPlugPlayNotification. Portanto, a rotina pode ser chamada depois que o método IoUnregisterPlugPlayNotification tiver retornado. Se necessário, um driver deve implementar seu próprio mecanismo para ignorar as notificações após IoUnregisterPlugPlayNotification foi chamado.
IoUnregisterPlugPlayNotification remove um registro de notificação PnP; ou seja, o registro de uma rotina de retorno de chamada de driver para uma categoria de evento PnP.
Os drivers devem cancelar o registro de uma notificação primeiro e, em seguida, liberar qualquer buffer de contexto relacionado.
Um driver não pode ser descarregado até remover todos os registros de notificação PnP porque há uma referência em seu objeto de driver para cada registro ativo.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |