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

Weitere Informationen

IoWMIOpenBlock

WNODE_EVENT_ITEM