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

추가 정보

IoWMIOpenBlock

WNODE_EVENT_ITEM