Función IoWMISetNotificationCallback (wdm.h)
La rutina IoWMISetNotificationCallback registra una devolución de llamada de notificación para un evento WMI.
Sintaxis
NTSTATUS IoWMISetNotificationCallback(
[in, out] PVOID Object,
[in] WMI_NOTIFICATION_CALLBACK Callback,
[in, optional] PVOID Context
);
Parámetros
[in, out] Object
Puntero a un objeto de bloque de datos WMI. El autor de la llamada abre el objeto de bloque de datos para el evento WMI con la rutina IoWMIOpenBlock . El objeto debe abrirse con el derecho de acceso WMIGUID_NOTIFICATION.
[in] Callback
Puntero a una función del formulario:
XxxWmiNotificationCallback(PVOID Wnode, PVOID Context);
WMI llama a esta función para notificar al autor de la llamada que se ha producido el evento especificado. El parámetro Wnode de la rutina de devolución de llamada apunta a la estructura WNODE_EVENT_ITEM devuelta por el controlador que desencadena el evento. El parámetro Context de la rutina de devolución de llamada apunta al valor especificado en el parámetro Context de la rutina IoWMISetNotificationCallback .
[in, optional] Context
Especifica el valor que WMI pasa a la rutina de devolución de llamada cuando se produce el evento.
Valor devuelto
Esta rutina devuelve STATUS_SUCCESS correcto y el código de error NTSTATUS adecuado en caso de error.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |