Función KsStreamPointerLock (ks.h)

La función KsStreamPointerLock intenta bloquear el puntero de flujo especificado.

Sintaxis

KSDDKAPI NTSTATUS KsStreamPointerLock(
  [in] PKSSTREAM_POINTER StreamPointer
);

Parámetros

[in] StreamPointer

Puntero a una estructura KSSTREAM_POINTER que representa el puntero de secuencia que se va a intentar bloquear.

Valor devuelto

KsStreamPointerLock devuelve STATUS_SUCCESS, lo que indica que el puntero de secuencia se ha bloqueado o un código de error adecuado. STATUS_DEVICE_NOT_READY es el código de error habitual que indica que no se pudo bloquear el marco. Este código de error suele significar que se canceló el marco al que estaba apuntando StreamPointer .

Comentarios

Un puntero de flujo bloqueado garantiza que hay una trama de datos asociada al puntero de secuencia y que esta trama no se cancela siempre que se mantenga el bloqueo. El minidriver debe bloquear un puntero de flujo antes de intentar acceder a los datos a los que apunta el puntero de flujo.

Si el pin al que hace referencia el puntero de secuencia especifica que se deben generar asignaciones de dispersión o recopilación de DMA mediante KSPIN_FLAG_GENERATE_MAPPINGS, AVStream genera las asignaciones cuando el puntero de secuencia está bloqueado.

Consulte también Stream punteros.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows XP y en sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX.
Plataforma de destino	Universal
Encabezado	ks.h (incluye Ks.h)
Library	Ks.lib
IRQL	<=DISPATCH_LEVEL

Consulte también

KsStreamPointerUnlock