IoWMISetNotificationCallback-Funktion (wdm.h)
Die IoWMISetNotificationCallback-Routine registriert einen Benachrichtigungsrückruf für ein WMI-Ereignis.
Syntax
NTSTATUS IoWMISetNotificationCallback(
[in, out] PVOID Object,
[in] WMI_NOTIFICATION_CALLBACK Callback,
[in, optional] PVOID Context
);
Parameter
[in, out] Object
Zeiger auf ein WMI-Datenblockobjekt. Der Aufrufer öffnet das Datenblockobjekt für das WMI-Ereignis mit der IoWMIOpenBlock-Routine . Das Objekt muss mit dem Zugriffsrecht WMIGUID_NOTIFICATION geöffnet werden.
[in] Callback
Zeiger auf eine Funktion des Formulars:
XxxWmiNotificationCallback(PVOID Wnode, PVOID Context);
WMI ruft diese Funktion auf, um den Aufrufer zu benachrichtigen, dass das angegebene Ereignis aufgetreten ist. Der Wnode-Parameter der Rückrufroutine verweist auf die WNODE_EVENT_ITEM-Struktur , die vom Treiber zurückgegeben wird, der das Ereignis auslöst. Der Context-Parameter der Rückrufroutine verweist auf den Wert, der im Context-Parameter der IoWMISetNotificationCallback-Routine angegeben ist.
[in, optional] Context
Gibt den Wert an, den WMI an die Rückrufroutine übergibt, wenn das Ereignis auftritt.
Rückgabewert
Diese Routine gibt STATUS_SUCCESS bei Erfolg und den entsprechenden NTSTATUS-Fehlercode bei Einem Fehler zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |