Compartir a través de


Función KsGateCaptureThreshold (ks.h)

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

Consulte también

KsGateAddOffInputToAnd

KsGateAddOffInputToOr

KsGateAddOnInputToAnd

KsGateAddOnInputToOr

KsGateGetStateUnsafe

KsGateInitializeAnd

KsGateInitializeOr

KsGateRemoveOffInputFromAnd

KsGateRemoveOffInputFromOr

KsGateRemoveOnInputFromAnd

KsGateRemoveOnInputFromOr

KsGateTurnInputOff

KsGateTurnInputOn