KsPinRegisterIrpCompletionCallback 함수(ks.h)
KsPinRegisterIrpCompletionCallback 함수는 지정된 핀에 대한 미니드라이버 정의 콜백 루틴을 등록합니다. AVStream은 IRP가 회로 주위의 패스를 완료하고 IRP와 연결된 프레임이 재활용되거나 사용 중지될 때 미니드라이버 제공 루틴을 호출합니다.
구문
void KsPinRegisterIrpCompletionCallback(
[in] PKSPIN Pin,
[in] PFNKSPINIRPCOMPLETION IrpCompletion
);
매개 변수
[in] Pin
완성 콜백을 등록할 KSPIN 구조체에 대한 포인터입니다.
[in] IrpCompletion
이 매개 변수는 IRP가 회로 통과를 완료하고 재활용 또는 사용 중지될 때 호출할 AVStrMiniPinIrpCompletion 루틴의 주소를 제공합니다.
반환 값
없음
설명
핀이 KSSTATE_ACQUIRE 들어가기 전에 IRQL=PASSIVE_LEVEL KsPinRegisterIrpCompletionCallback을 호출해야 합니다. 핀 상태에 대한 자세한 내용은 KSSTATE를 참조하세요.
이 함수는 핀 생성 디스패치에서 자주 호출됩니다. KSPIN_DISPATCH 참조하세요.
KsPinRegisterIrpCompletionCallback 은 IRP 원본 핀에만 유용하며 일반적으로 데이터 원본 핀에서 사용됩니다. 데이터 원본 핀의 경우 IRP가 핀으로 다시 완료되고 재활용하려고 하면 콜백이 수행됩니다. 그러나 데이터 싱크 핀의 경우 콜백은 IRP 완성에 직접 연결되지 않습니다. AVStream은 IRP가 재활용을 위해 반환될 때 콜백을 계속합니다. 이 반환은 IRP가 포함된 데이터를 사용해야 하는 모든 큐를 통과할 때까지 발생하지 않습니다. IRP 원본/싱크 핀과 데이터 원본/싱크 핀에 대한 자세한 내용은 KSPIN_DESCRIPTOR 구조의 DataFlow 및 통신 멤버를 참조하세요.
KsPinRegisterIrpCompletionCallback 은 이 루틴이 핀을 새 모드로 배치하지 않는다는 점에서 KsPinRegisterFrameReturnCallback 과 크게 다릅니다. 콜백 루틴을 등록하기만 하면 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | ks.h(Ks.h 포함) |
| 라이브러리 | Ks.lib |
| IRQL | PASSIVE_LEVEL |