PFNKSADDEVENT 콜백 함수(ks.h)

아티클
08/07/2023

AVStream 미니드라이버의 AVStrMiniAddEvent 루틴은 클라이언트가 이벤트에 대한 알림을 받도록 등록할 때 호출됩니다. 이 루틴은 선택 사항입니다.

구문

PFNKSADDEVENT Pfnksaddevent;

NTSTATUS Pfnksaddevent(
  [in] PIRP Irp,
  [in] PKSEVENTDATA EventData,
  [in] _KSEVENT_ENTRY *EventEntry
)
{...}

매개 변수

[in] Irp

이벤트 추가 요청을 설명하는 IRP를 지정합니다.

[in] EventData

이 이벤트에 대한 알림 방법을 설명하는 KSEVENTDATA 구조체에 대한 포인터입니다.

[in] EventEntry

이벤트가 트리거되는 방법을 설명하는 AVStream에서 생성된 KSEVENT_ENTRY 구조체에 대한 포인터입니다.

반환 값

AVStrMiniAddEvent 는 사용 중인 이벤트와 관련된 STATUS_SUCCESS 또는 오류를 반환해야 합니다.

설명

이벤트 처리기 추가를 제공하지 않으면 AVStream은 개체 목록에 이벤트를 추가합니다. AVStream의 이벤트 처리를 참조하세요.

이 콜백은 공급업체별 동작을 구현한 다음 KsFilterAddEvent 또는 KsPinAddEvent를 호출하는 경우가 많습니다. 미니드라이버가 KsFilterAddEvent 또는 KsPinAddEvent 호출에서 여기에 수신된 EventEntry 포인터를 전달합니다.

미니 드라이버는 KSEVENT_ITEM 구조체의 AddHandler 멤버에서 이 루틴의 주소를 지정합니다. AVStream의 이벤트 처리는 미니드라이버가 클래스 드라이버에 이 구조를 제공하는 방법을 설명합니다.

AVStream 미니드라이버가 AddHandler 를 NULL이 아닌 것으로 지정하는 경우 AVStream은 개체의 이벤트 목록에 항목을 추가하지 않습니다. 미니드라이버가 AddHandler 를 지정하고 KsDefaultAddEventHandler() 또는 Ks*AddEvent 호출을 통해 개체의 이벤트 목록에 이벤트를 추가하지 않으면 미니드라이버가 이벤트 정리를 담당합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	ks.h(Ks.h 포함)