PCPFNEVENT_HANDLER 콜백 함수(portcls.h)

아티클
02/07/2025

EventHandler 루틴은 이벤트 요청을 처리합니다.

통사론

PCPFNEVENT_HANDLER PcpfneventHandler;

NTSTATUS PcpfneventHandler(
  [in] PPCEVENT_REQUEST EventRequest
)
{...}

매개 변수

[in] EventRequest

초기화된 PCEVENT_REQUEST 구조체에 대한 포인터

반환 값

호출에 성공하면 이벤트 처리기가 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.

발언

미니포트 드라이버가 노출하는 각 이벤트는 이벤트 처리기와 연결됩니다. 이벤트 처리기의 목적은 포트 드라이버 및 해당 클라이언트의 이벤트 요청을 처리하는 것입니다. EventRequest 이벤트에 대한 다음 정보를 포함하는 처리기에 대한 입력 매개 변수입니다.

이벤트 집합 GUID 및 이벤트 ID입니다.
이벤트를 트리거하는 방법입니다.
대상 미니포트 개체 및(핀의 경우) 스트림 개체에 대한 포인터입니다.

이는 속성 요청과 함께 제공되는 정보 유형과 유사합니다.

미니포트 드라이버는 IMiniport::GetDescription 메서드를 통해 이벤트 처리기를 노출합니다. 이 메서드는 미니포트 드라이버와 연결된 포트 드라이버가 함께 구현하는 필터를 정의하는 설명자 구조(PCFILTER_DESCRIPTOR참조)를 출력합니다. 이 구조체에는 미니포트 드라이버의 자동화 테이블(PCAUTOMATION_TABLE참조)에 대한 포인터가 포함되며, 미니포트 드라이버 이벤트 배열에 대한 포인터가 포함됩니다. 각 배열 요소는 PCEVENT_ITEM 구조체이며 이벤트에 대한 처리기에 대한 PCPFNEVENT_HANDLER 함수 포인터를 포함합니다.

EventHandler 루틴은 페이지가 없는 메모리에 있어야 합니다.