다음을 통해 공유

KsPinRegisterFrameReturnCallback 함수(ks.h)

  • 아티클

KsPinRegisterFrameReturnCallback 함수는 지정된 핀에 대해 AVStream을 사용하여 프레임 반환 콜백을 등록합니다.

구문

void KsPinRegisterFrameReturnCallback(
  [in] PKSPIN              Pin,
  [in] PFNKSPINFRAMERETURN FrameReturn
);

매개 변수

[in] Pin

프레임 반환 콜백을 등록하여 삽입 모드로 배치하려는 AVStream KSPIN 구조체에 대한 포인터입니다.

[in] FrameReturn

이 매개 변수는 미니드라이버에서 제공하는 AVStrMiniFrameReturn 루틴의 주소를 제공합니다.

반환 값

없음

설명

핀이 KSSTATE_STOP KSSTATE_ACQUIRE 전환하기 전에 프레임 반환 콜백을 등록한 경우 핀은 삽입 모드로 배치됩니다. 이는 핀이 버퍼를 수신하고 채우지 않고 KsPinSubmitFrame 또는 KsPinSubmitFrameMdl을 사용하여 수동으로 회로에 데이터 프레임을 삽입한다는 것을 나타냅니다. 데이터 프레임이 회로 주위의 이동을 완료하고 제출된 핀으로 돌아오면 AVStream은 AVStrMiniFrameReturn을 호출하여 이를 재활용합니다.

이 함수를 호출하는 미니드라이버에서는 회로에 프레임을 직접 삽입해야 합니다. 채울 버퍼를 받지 않으며 대부분의 미니드라이버와 마찬가지로 큐와 직접 상호 작용하지 않습니다. 또한 커널 파이프 섹션을 만들기 전에 프레임 반환 콜백을 등록해야 합니다. 커널 파이프 섹션은 핀이 KSSTATE_ACQUIRE 전환될 때 만들어집니다. 자세한 내용은 프레임 삽입을 참조하세요.

요구 사항

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

추가 정보

AVStrMiniFrameReturn

KsPinSubmitFrame

KsPinSubmitFrameMdl