IoUnregisterPlugPlayNotification-Funktion (wdm.h)

  • Artikel

Diese Routine ist in Windows 7 und höheren Versionen von Windows veraltet. Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise .

Die IoUnregisterPlugPlayNotification-Routine entfernt die Registrierung der Rückrufroutine eines Treibers für ein PnP-Ereignis.

Syntax

NTSTATUS IoUnregisterPlugPlayNotification(
  [in] PVOID NotificationEntry
);

Parameter

[in] NotificationEntry

Zeiger auf einen undurchsichtigen Wert, der die zu entfernende Registrierung darstellt. Der Wert wurde von einem vorherigen Aufruf von IoRegisterPlugPlayNotification zurückgegeben.

Rückgabewert

IoUnregisterPlugPlayNotification gibt immer STATUS_SUCCESS zurück, wenn NotificationEntry gültig ist.

Hinweise

In Windows 7 und höheren Versionen von Windows ist diese Funktion veraltet und wird nur zur Unterstützung vorhandener Treiber bereitgestellt. Verwenden Sie stattdessen die IoUnregisterPlugPlayNotificationEx-Routine .

Das System synchronisiert nicht zwischen der Ausführung der Benachrichtigungsroutine und IoUnregisterPlugPlayNotification. Daher kann die Routine aufgerufen werden, nachdem die IoUnregisterPlugPlayNotification-Methode zurückgegeben wurde. Bei Bedarf sollte ein Treiber einen eigenen Mechanismus implementieren, um alle Benachrichtigungen zu ignorieren, nachdem IoUnregisterPlugPlayNotification aufgerufen wurde.

IoUnregisterPlugPlayNotification entfernt eine PnP-Benachrichtigungsregistrierung. d. h. die Registrierung einer Treiberrückrufroutine für eine PnP-Ereigniskategorie.

Treiber sollten zuerst die Registrierung einer Benachrichtigung aufheben und dann den zugehörigen Kontextpuffer freigeben.

Ein Treiber kann erst entladen werden, wenn er alle PnP-Benachrichtigungsregistrierungen entfernt, da für jede aktive Registrierung ein Verweis auf sein Treiberobjekt vorhanden ist.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotificationEx