IoUnregisterPlugPlayNotification-Funktion (wdm.h)
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) |