Função IoUnregisterPlugPlayNotification (wdm.h)

  • Artigo

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)

Confira também

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotificationEx