Función de devolución de llamada PFNKSPIN (ks.h)
Cuando se llama a una rutina de devolución de llamada de un minidriver AVStream:
- Hay datos disponibles para que se procese una estructura KSPIN . Use esta rutina para realizar el procesamiento centrado en patillas.
- El KSPIN pertinente actúa como un anclaje receptor y está conectado a un pin de origen de AVStream.
Sintaxis
PFNKSPIN Pfnkspin;
NTSTATUS Pfnkspin(
[in] PKSPIN Pin
)
{...}
Parámetros
[in] Pin
Puntero al KSPIN que tiene datos de trama disponibles para procesar.
Valor devuelto
Devuelve STATUS_SUCCESS para continuar con el procesamiento. Devuelve STATUS_PENDING para detener el procesamiento hasta el siguiente evento desencadenador.
Comentarios
Acerca de AVStrMiniPinProcess
El minidriver especifica la dirección de esta rutina en el miembro Process de su estructura de KSPIN_DISPATCH .
Indique que un filtro usa procesamiento centrado en patillas proporcionando esta función de distribución. El minidriver establece marcas de anclaje en la estructura de KSPIN_DESCRIPTOR_EX pertinente que determina cuándo AVStream llama a AVStrMiniPinProcess. Si el minidriver no establece ninguna marca en el descriptor, el comportamiento predeterminado es que AVStream llama a AVStrMiniPinProcess cuando los nuevos datos llegan a una cola vacía anteriormente. Consulte Pin-Centric Procesamiento para obtener más información sobre los desencadenadores de procesamiento.
Después del procesamiento, el minidriver puede impedir que el marco se complete clonando el puntero de flujo de borde inicial. Para ello, llame a KsStreamPointerClone. Consulte Punteros de borde inicial y final Stream.
Como alternativa, especifique un borde final distinto estableciendo KSPIN_FLAG_DISTINCT_TRAILING_EDGE en KSPIN_DESCRIPTOR_EX. Una tercera opción no es avanzar el puntero de flujo de borde inicial.
El envío del proceso se realiza en el IRQL predeterminado = PASSIVE_LEVEL, o posiblemente en DISPATCH_LEVEL si el minidriver ha especificado KSPIN_FLAG_DISPATCH_LEVEL_PROCESSING en el KSPIN_DESCRIPTOR_EX pertinente.
Esta rutina es opcional.
Acerca de AVStrMiniPinConnect
El minidriver especifica la dirección de esta rutina en el miembro Connect de su estructura de KSPIN_DISPATCH .
Devuelve STATUS_SUCCESS o el error devuelto por el intento de establecer una conexión interna. No devuelva STATUS_PENDING.
Esta rutina es opcional.
Vea también pins KS.
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 | Escritorio |
| Encabezado | ks.h (incluya Ks.h) |
| IRQL | (Consulte la sección Comentarios) |