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 WMIGUID_NOTIFICATION Zugriffsrecht geöffnet werden.
[in] Callback
Zeiger auf eine Funktion des Formulars:
XxxWmiNotificationCallback(PVOID Wnode, PVOID Context);
WMI ruft diese Funktion auf, um den Aufrufer darüber zu benachrichtigen, dass das angegebene Ereignis aufgetreten ist. Der Wnode Parameter der Rückrufroutine verweist auf die vom Treiber zurückgegebene WNODE_EVENT_ITEM Struktur, die 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 Fehlern zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |