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 |