WdfWmiInstanceFireEvent 함수(wdfwmi.h)

[KMDF에만 적용]

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

구문

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

매개 변수

[in] WmiInstance

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

[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