Función KsGateCaptureThreshold (ks.h)

Artículo
02/29/2024

La función KsGateCaptureThreshold se usa para capturar una entrada ON de una puerta AND especificada por Gate.

Sintaxis

BOOLEAN KsGateCaptureThreshold(
  [in] PKSGATE Gate
);

Parámetros

[in] Gate

Puntero a una estructura KSGATE que representa la puerta AND para la que se va a capturar una entrada ON de forma sincrónica.

Valor devuelto

KsGateCaptureThreshold devuelve TRUE si la puerta AND estaba abierta originalmente. Tenga en cuenta que devolver TRUE implica que la puerta se cerró para que ningún otro subproceso pueda capturar simultáneamente la puerta y comenzar el procesamiento.

Comentarios

KsGateCaptureThreshold comprueba el estado de la puerta AND dada. Si la puerta está abierta, desactiva una entrada a la puerta, pasando así la puerta a un estado cerrado. Si se cierra la puerta, la función no hace nada. A diferencia de KsGateGetStateUnsafe, esta llamada se realiza de forma sincrónica con respecto a otros cambios de estado de puerta. Es el mecanismo de sincronización principal para el procesamiento basado en el control de puerta.

A pesar de su nombre, esta función es solo una llamada válida para puertas AND, no puertas en general. Sin embargo, AVStream no comprueba si Gate es una puerta AND o una puerta OR. Es responsabilidad del autor de la llamada asegurarse de que la llamada solo se realiza en las puertas AND.

La llamada se realiza mediante funciones interbloqueadas y, por tanto, es sincrónica con respecto a cualquiera de las demás funciones de cambio de estado de puerta; también es un método muy eficaz de control de procesos.

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	Escritorio
Encabezado	ks.h (incluya Ks.h)
IRQL	Cualquier nivel