Função IoUnregisterPlugPlayNotification (wdm.h)
Essa rotina está obsoleta no Windows 7 e em versões posteriores do Windows. Para obter mais informações, consulte a seção Comentários abaixo.
A rotina 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.
Retornar valor
IoUnregisterPlugPlayNotification sempre retornará STATUS_SUCCESS se NotificationEntry for válido.
Comentários
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 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 quaisquer notificações depois que IoUnregisterPlugPlayNotification tiver sido 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 |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regras de conformidade da DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |