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 de KSPIN. Use esta rutina para realizar Pin-Centric procesamiento.
- El KSPIN pertinente sirve como un pin 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 fotogramas disponibles para procesar.
Valor devuelto
Devuelve STATUS_SUCCESS para continuar el procesamiento. Devuelve STATUS_PENDING para detener el procesamiento hasta el siguiente evento desencadenador.
Observaciones
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 Pin-Centric de procesamiento proporcionando esta función de distribución. El minidriver establece marcas de anclaje en la estructura de KSPIN_DESCRIPTOR_EX pertinente que determinan 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 llegan nuevos datos a una cola vacía previamente. 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 fotograma se complete clonando el puntero de flujo de borde inicial. Para ello, llame a KsStreamPointerClone. Consulte punteros de flujo de borde inicial y final.
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_EXpertinente.
Esta rutina es opcional.
Acerca de AVStrMiniPinConnect
El minidriver especifica la dirección de esta rutina en el miembro connect de 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.
Consulte también pins KS.
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 | Escritorio |
| encabezado de | ks.h (incluya Ks.h) |
| irQL | (Consulte la sección Comentarios) |
Consulte también
de procesamiento deFilter-Centric
de procesamiento dePin-Centric