피드백

WdfWmiInstanceFireEvent 함수(wdfwmi.h)

  • 아티클
  • 읽는 데 2분 걸림

[KMDF에만 적용]

WdfWmiInstanceFireEvent 메서드는 이벤트 알림을 수신하도록 등록된 WMI 클라이언트에 WMI 이벤트를 보냅니다.

구문

NTSTATUS WdfWmiInstanceFireEvent(
  [in]           WDFWMIINSTANCE WmiInstance,
  [in, optional] ULONG          EventDataSize,
  [in, optional] PVOID          EventData
);

매개 변수

[in] WmiInstance

드라이버가 WdfWmiInstanceCreate에 대한 이전 호출에서 가져온 WMI 인스턴스 개체에 대한 핸들입니다.

[in, optional] EventDataSize

EventData가 가리키는 이벤트 데이터의 크기(바이트)입니다.

[in, optional] EventData

이벤트 데이터에 대한 포인터이거나 이벤트 데이터가 없는 경우 NULL 입니다.

반환 값

WdfWmiInstanceFireEvent 는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 메서드는 다음 값 중 하나를 반환할 수 있습니다.

반환 코드 설명
STATUS_INSUFFICIENT_RESOURCES
 메모리가 부족했습니다.
STATUS_UNSUCCESSFUL
 프레임워크가 WMI와 통신하지 못했습니다.
STATUS_BUFFER_OVERFLOW
 이벤트 데이터 버퍼가 너무 큽 수 있습니다.

이 메서드는 다른 NTSTATUS 값을 반환할 수도 있습니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사가 발생합니다.

설명

WMI 클라이언트가 이벤트 알림을 등록한 경우에만 드라이버에서 WdfWmiInstanceFireEvent 를 호출해야 합니다. 드라이버는 EvtWmiProviderFunctionControl 콜백 함수를 제공하거나 WdfWmiProviderIsEnabled를 호출하여 WdfWmiInstanceFireEvent를 호출해야 하는지 여부를 결정할 수 있습니다.

드라이버는 EventData 매개 변수가 가리키는 버퍼에 이벤트별 데이터(있는 경우)를 배치해야 합니다. 프레임워크는 필요한 모든 WMI 헤더 정보를 추가합니다.

WdfWmiInstanceFireEvent 메서드에 대한 자세한 내용은 Framework-Based 드라이버에서 WMI 지원을 참조하세요.

예제

다음 코드 예제에서는 WMI 클라이언트에 WMI 이벤트를 보냅니다.

MY_WMI_EVENT_DATA eventData;
NTSTATUS  status;

status = WdfWmiInstanceFireEvent(
                                 WmiInstance,
                                 sizeof(eventData),
                                 (PVOID)&eventData
                                 );

요구 사항

   
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
머리글 wdfwmi.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL <= APC_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

참고 항목

EvtWmiProviderFunctionControl

WdfWmiInstanceCreate

WdfWmiProviderIsEnabled