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 |