Función KsPinGetLeadingEdgeStreamPointer (ks.h)

Artículo
08/07/2023

La función KsPinGetLeadingEdgeStreamPointer adquiere el puntero de flujo de borde inicial para la cola asociada al pin especificado.

Sintaxis

KSDDKAPI PKSSTREAM_POINTER KsPinGetLeadingEdgeStreamPointer(
  [in] PKSPIN                 Pin,
  [in] KSSTREAM_POINTER_STATE State
);

Parámetros

[in] Pin

Puntero a la estructura KSPIN que posee la cola para la que se debe adquirir el puntero de flujo de borde inicial.

[in] State

Este parámetro especifica cómo adquirir el puntero de flujo de borde inicial. Puede ser uno de los siguientes:

KSSTREAM_POINTER_STATE_UNLOCKED

Adquiera el puntero de flujo de borde inicial, independientemente de si hace referencia a una trama de datos o no.

No se puede realizar ningún intento de acceder a los datos asociados al puntero hasta que el puntero esté bloqueado. Tenga en cuenta también que se pueden cancelar los fotogramas asociados a un puntero de flujo desbloqueado.

KSSTREAM_POINTER_STATE_LOCKED

Adquiera y bloquee el puntero de flujo de borde inicial. Si no hay ninguna trama de datos asociada al puntero de secuencia, devuelva NULL. Si se devuelve un puntero distinto denull , es un puntero de flujo bloqueado y tiene una trama de datos asociada. No se pueden cancelar los marcos asociados a un puntero de flujo bloqueado.

Valor devuelto

KsPinGetLeadingEdgeStreamPointer devuelve un puntero a una estructura de KSSTREAM_POINTER o NULL. Es posible que se produzca un valor devuelto de NULL porque no hay ninguna cola asociada al pin, lo que indica que el pin no usa el mecanismo de transporte estándar. Como alternativa, puede producirse un valor devuelto de NULL porque se produjo un intento de bloquear el borde inicial, lo que indica que no hay ninguna trama de datos asociada al borde inicial.

Comentarios

Los filtros que implementan el procesamiento centrado en pin suelen llamar a KsPinGetLeadingEdgeStreamPointer.

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	<=DISPATCH_LEVEL