IoWMISetNotificationCallback 함수(wdm.h)
IoWMISetNotificationCallback 루틴은 WMI 이벤트에 대한 알림 콜백을 등록합니다.
구문
NTSTATUS IoWMISetNotificationCallback(
[in, out] PVOID Object,
[in] WMI_NOTIFICATION_CALLBACK Callback,
[in, optional] PVOID Context
);
매개 변수
[in, out] Object
WMI 데이터 블록 개체에 대한 포인터입니다. 호출자는 IoWMIOpenBlock 루틴을 사용하여 WMI 이벤트에 대한 데이터 블록 개체를 엽니다. 개체는 WMIGUID_NOTIFICATION 액세스 권한으로 열어야 합니다.
[in] Callback
폼의 함수에 대한 포인터:
XxxWmiNotificationCallback(PVOID Wnode, PVOID Context);
WMI는 이 함수를 호출하여 호출자에게 지정된 이벤트가 발생했음을 알립니다. 콜백 루틴의 Wnode 매개 변수는 이벤트를 트리거하는 드라이버에서 반환하는 WNODE_EVENT_ITEM 구조를 가리킵니다. 콜백 루틴의 Context 매개 변수는 IoWMISetNotificationCallback 루틴의 Context 매개 변수에 지정된 값을 가리킵니다.
[in, optional] Context
이벤트가 발생할 때 WMI가 콜백 루틴에 전달하는 값을 지정합니다.
반환 값
이 루틴은 성공 시 STATUS_SUCCESS 반환하고 실패 시 적절한 NTSTATUS 오류 코드를 반환합니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 유니버설 |
헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
라이브러리 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |