PCPFNEVENT_HANDLER 콜백 함수(portcls.h)

아티클
02/26/2024

루틴은 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 페이지가 없는 메모리에 있어야 합니다.