Función KsPinGetAvailableByteCount (ks.h)

Artículo
05/23/2024

La rutina KsPinGetAvailableByteCount genera el número de bytes de datos de entrada delante del borde inicial y el número de bytes de búfer de salida delante del borde inicial, ambos para la cola de un pin especificado por el autor de la llamada.

Sintaxis

KSDDKAPI NTSTATUS KsPinGetAvailableByteCount(
  [in]            PKSPIN Pin,
  [out, optional] PLONG  InputDataBytes,
  [out, optional] PLONG  OutputBufferBytes
);

Parámetros

[in] Pin

Puntero a una estructura KSPIN para la que se van a calcular estos parámetros de cola.

[out, optional] InputDataBytes

Puntero a un valor LONG en el que la rutina devuelve el número de bytes de datos de entrada delante del borde inicial. El llamador establece en NULL si no se solicita este valor.

[out, optional] OutputBufferBytes

Puntero a un valor LONG en el que la rutina devuelve el número de bytes de búfer de salida delante del borde inicial. El llamador establece en NULL si no se solicita este valor.

Valor devuelto

Devuelve STATUS_SUCCESS si se han recuperado los recuentos solicitados. Un estado de devolución incorrecto indica que Pin no tiene una cola asociada.

Comentarios

Las patillas que no están en lugar deben usar InputDataBytes para los pines de entrada y OutputBufferBytes para las patillas de salida.

No se garantiza que los resultados de esta llamada sean seguros a menos que la exclusión mutua de procesamiento se mantenga en el momento de la llamada o el autor de la llamada se sincronice de forma privada antes de llamar a la rutina. Para sincronizar la sincronización privada, asegúrese de que el pin no realiza la transición de Adquirir a Detener mientras se ejecuta la rutina. Consulte Procesamiento de exclusión mutua en AVStream.

Tenga en cuenta también que la transformación local puede proporcionar recuentos de entrada y salida.

En Windows XP y DirectX 8.0, el recuento de InputDataBytes no es válido a menos que los fotogramas que recibe el filtro estén llenos.

Para obtener más información, consulte Punteros de borde inicial y final Stream.

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