다음을 통해 공유


KsPinGenerateEvents 함수(ks.h)

KsPinGenerateEvents 함수는 Pin이벤트 목록에 있는 표시된 형식의 이벤트를 생성합니다.

통사론

void KsPinGenerateEvents(
  [in]           PKSPIN                     Pin,
  [in, optional] const GUID                 *EventSet,
  [in]           ULONG                      EventId,
  [in]           ULONG                      DataSize,
  [in, optional] PVOID                      Data,
  [in, optional] PFNKSGENERATEEVENTCALLBACK CallBack,
  [in, optional] PVOID                      CallBackContext
);

매개 변수

[in] Pin

이벤트를 생성할 KSPIN 구조체에 대한 포인터입니다.

[in, optional] EventSet

생성할 이벤트를 결정하기 위해 일치시킬 이벤트 집합 GUID에 대한 포인터입니다. 이 매개 변수가 NULL 경우 일치 이벤트를 결정하는 데 GUID 설정이 고려되지 않습니다.

[in] EventId

생성할 이벤트를 결정하기 위해 일치시킬 이벤트 ID입니다.

[in] DataSize

데이터 이벤트를 생성할 데이터의 크기(바이트)입니다.

[in, optional] Data

데이터 버퍼에 대한 포인터입니다. 데이터 이벤트를 생성하는지 지정합니다.

[in, optional] CallBack

지정된 이벤트를 생성해야 하는지 여부를 결정하기 위해 호출되는 호출자 지정 함수에 대한 포인터입니다. NULL 경우 이벤트를 생성해야 하는지 여부를 확인하기 위해 콜백 확인이 수행되지 않습니다(*EventSet *및 EventId만 사용됨). 프로토타입은 다음과 같습니다.

BOOLEAN CallBack
(IN PVOID Context,
    IN PKSEVENT_ENTRY EventEntry);

KsPinGenerateEvents 콜백에 대한 Context 매개 변수로 변경되지 않은 CallBackContext 매개 변수를 전달합니다. 콜백 함수는 EventEntry 생성해야 하는 경우 TRUE 반환합니다. 그렇지 않으면 false 반환됩니다.

[in, optional] CallBackContext

콜백 함수 콜백전달되는 호출자 지정 컨텍스트에 대한 포인터입니다.

반환 값

없음

발언

이 함수를 호출할 때 미니 드라이버는 Data 배치하고 CallBackContext 잠겨 있고 페이지를 작성할 수 없는 데이터 세그먼트에 배치해야 합니다. 콜백 DISPATCH_LEVEL 만들어집니다. 콜백 함수는 잠긴 세그먼트에 있어야 하며 IRQL = DISPATCH_LEVEL 실행되도록 준비해야 합니다. DX8 추가 문제가 있습니다. EventSet 잠긴 데이터 세그먼트에 있어야 합니다.

이는 필요한 형식 캐스팅을 수행하는 KsGenerateEvents 인라인 함수 호출입니다. 미니 드라이버는 일반적으로 KsGenerateEvents직접 호출하는 대신 이 버전을 호출해야 합니다.

다음 세 가지 조건이 유지되면 이벤트가 생성됩니다.

  • 이벤트는 *Pin의 *이벤트 목록에 있고 *EventId *는 이벤트의 ID와 일치합니다.

  • EventSet 이벤트의 집합 GUID와 일치하거나 NULL .

  • *CallBack *은(는) NULL 일치 항목에 권한을 부여합니다.

자세한 내용은 AVStream KS 이벤트 이벤트 처리를 참조하세요.

요구 사항

요구
지원되는 최소 클라이언트 Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다.
대상 플랫폼 바탕 화면
헤더 ks.h(Ks.h 포함)
라이브러리 Ks.lib
IRQL <=DISPATCH_LEVEL(설명 참조)

참고 항목

KSEVENT_ENTRY

KsAddEvent

KsFilterGenerateEvents

KsGenerateEvents