Función KsPinRegisterFrameReturnCallback (ks.h)

La función KsPinRegisterFrameReturnCallback registra una devolución de llamada de devolución de fotogramas con AVStream para un pin determinado.

Sintaxis

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

Parámetros

[in] Pin

Puntero a la estructura KSPIN de AVStream que desea colocar en modo de inyección registrando una devolución de llamada de devolución de fotograma.

[in] FrameReturn

Este parámetro proporciona la dirección de una rutina AVStrMiniFrameReturn proporcionada por minidriver.

Valor devuelto

None

Observaciones

Si un pin ha registrado una devolución de llamada de devolución de fotogramas antes de realizar la transición de KSSTATE_STOP a KSSTATE_ACQUIRE, la patilla se coloca en modo de inyección. Esto indica que el pin no recibirá búferes y los rellenará, sino insertar manualmente fotogramas de datos en el circuito mediante KsPinSubmitFrame o KsPinSubmitFrameMdl. Cuando el marco de datos completa su recorrido alrededor del circuito y vuelve al pin en el que se envió, AVStream lo recicla llamando a AVStrMiniFrameReturn.

Los minidrivers que llaman a esta función son directamente responsables de insertar fotogramas en el circuito; no reciben búferes para rellenar y no interactúan directamente con la cola, al igual que la mayoría de los minidrivers. Tenga en cuenta también que la devolución de llamada de devolución de fotogramas debe registrarse antes de crear la sección de canalización del kernel. La sección de canalización del kernel se crea cuando el pin pasa a KSSTATE_ACQUIRE. Para obtener más información, vea Inyección de fotogramas.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX.
Plataforma de destino	Universal
Encabezado	ks.h (incluya Ks.h)
Library	Ks.lib
IRQL	PASSIVE_LEVEL

Consulte también

AVStrMiniFrameReturn

KsPinSubmitFrame

KsPinSubmitFrameMdl