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

Siehe auch

IoWMIOpenBlock-

WNODE_EVENT_ITEM