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 de KSPIN AVStream que desea colocar en modo de inyección registrando una devolución de llamada de devolución de fotogramas.
[in] FrameReturn
Este parámetro proporciona la dirección de una rutina de AVStrMiniFrameReturn proporcionada por minidriver.
Valor devuelto
Ninguno
Observaciones
Si un pin ha registrado una devolución de llamada de devolución de fotogramas antes de pasar 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á manualmente, 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 minidriveadores 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, como 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 la patilla pasa a KSSTATE_ACQUIRE. Para obtener más información, vea de inyección de fotogramas .
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| de la plataforma de destino de | Universal |
| encabezado de | ks.h (incluya Ks.h) |
| biblioteca de | Ks.lib |
| irQL | PASSIVE_LEVEL |