PHW_EVENT_ROUTINE 콜백 함수(strmini.h)

클래스 드라이버는 스트림 미니드라이버의 StrMiniEvent 루틴을 호출하여 미니드라이버에 이벤트를 사용하거나 사용하지 않도록 설정해야 한다는 신호를 보냅니다.

구문

PHW_EVENT_ROUTINE PhwEventRoutine;

NTSTATUS PhwEventRoutine(
  [in] IN PHW_EVENT_DESCRIPTOR EventDescriptor
)
{...}

매개 변수

[in] EventDescriptor

이벤트 및 이벤트를 사용하도록 설정해야 하는지 또는 사용하지 않도록 설정해야 하는지에 대해 설명합니다.

반환 값

이벤트 사용 이벤트의 경우 StrMiniEvent 는 이벤트가 성공적으로 활성화된 경우 STATUS_SUCCESS 반환하거나 오류 시 오류 코드를 반환합니다. 클래스 드라이버는 사용 안 함 요청에서 반환 값을 무시합니다.

설명

클래스 드라이버는 EventDescriptor-EventEntry>에서 전달하는 KSEVENT_ENTRY 구조를 큐에 추가합니다. StrMiniEvent가 종료되면 EventDescriptor의 다른 모든 멤버의 할당이 취소되므로 Minidriver에서 유지해야 하는 EventDescriptor의 EventData 멤버에 포함된 이벤트별 데이터를 미니 드라이버에 저장해야 합니다.

이를 위해 미니 드라이버는 이벤트를 선언하는 데 사용한 KSEVENT_ITEM 구조체의 ExtraEntryData 멤버에 0이 아닌 값을 제공하여 KSEVENT_ENTRY 구조체 바로 다음에 공간을 할당할 수 있습니다.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	strmini.h(Strmini.h 포함)