피드백

PFNKSPIN 콜백 함수(ks.h)

  • 아티클
  • 읽는 데 3분 걸림

AVStream 미니 드라이버의 콜백 루틴은 다음과 같은 경우에 호출됩니다.

구문

PFNKSPIN Pfnkspin;

NTSTATUS Pfnkspin(
  [in] PKSPIN Pin
)
{...}

매개 변수

[in] Pin

처리할 수 있는 프레임 데이터가 있는 KSPIN 에 대한 포인터입니다.

반환 값

처리를 계속하려면 STATUS_SUCCESS 반환합니다. 다음 트리거 이벤트까지 처리를 중지하려면 STATUS_PENDING 반환합니다.

설명

AVStrMiniPinProcess 정보

미니 드라이버는 해당 KSPIN_DISPATCH 구조의 프로세스 멤버에서 이 루틴의 주소를 지정합니다.

필터가 이 디스패치 함수를 제공하여 핀 중심 처리를 사용함을 나타냅니다. 미니 드라이버는 AVStream이 AVStrMiniPinProcess를 호출하는 시기를 결정하는 관련 KSPIN_DESCRIPTOR_EX 구조에 핀 플래그를 설정합니다. 미니 드라이버가 설명자에 플래그를 설정하지 않는 경우 기본 동작은 새 데이터가 이전에 빈 큐에 도착할 때 AVStrMiniPinProcess 를 호출하는 것입니다. 트리거 처리에 대한 자세한 내용은 Pin-Centric 처리를 참조하세요.

처리 후 미니 드라이버는 선행 에지 스트림 포인터를 복제하여 프레임이 완료되지 않도록 방지할 수 있습니다. 이렇게 하려면 KsStreamPointerClone을 호출합니다. 선행 및 후행 Edge 스트림 포인터를 참조하세요.

또는 KSPIN_DESCRIPTOR_EX KSPIN_FLAG_DISTINCT_TRAILING_EDGE 설정하여 고유한 후행 가장자리를 지정합니다. 세 번째 옵션은 선행 에지 스트림 포인터를 진행하지 않는 것입니다.

프로세스 디스패치는 기본 IRQL = PASSIVE_LEVEL 수행되거나 미니 드라이버 가 관련 KSPIN_DESCRIPTOR_EX KSPIN_FLAG_DISPATCH_LEVEL_PROCESSING 지정한 경우 DISPATCH_LEVEL 수 있습니다.

이 루틴은 선택 사항입니다.

AVStrMiniPinConnect 정보

미니 드라이버는 KSPIN_DISPATCH 구조의 커넥트 멤버에서 이 루틴의 주소를 지정합니다.

연결 내 설정 시도에서 반환된 STATUS_SUCCESS 또는 오류를 반환합니다. STATUS_PENDING 반환하지 마세요.

이 루틴은 선택 사항입니다.

KS 핀도 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
헤더 ks.h(Ks.h 포함)
IRQL (주의 섹션 참조)

참조

필터 중심 처리

KSPIN_DESCRIPTOR_EX

KSPIN_DISPATCH

KsStreamPointerClone

핀 중심 처리