Función KsPinGetLeadingEdgeStreamPointer (ks.h)
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 al estructura de KSPIN que posee la cola para la que se debe adquirir el puntero de flujo perimetral 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 los fotogramas asociados a un puntero de secuencia desbloqueado se pueden cancelar.
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 flujo, devuelva NULL. Si se devuelve un punterono null, es un puntero de flujo bloqueado y tiene una trama de datos asociada. Los marcos asociados a un puntero de flujo bloqueado no se pueden cancelar.
Valor devuelto
KsPinGetLeadingEdgeStreamPointer devuelve un puntero a una estructura de KSSTREAM_POINTER o NULL. Puede producirse un valor devuelto de NULL porque no hay ninguna cola asociada con el pin, lo que indica que la patilla 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.
Observaciones
Los filtros que implementan Pin-Centric Processing suelen llamar a KsPinGetLeadingEdgeStreamPointer.
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 | <=DISPATCH_LEVEL |
Consulte también
KsPinGetTrailingEdgeStreamPointer