KsGateCaptureThreshold 함수(ks.h)

아티클
02/29/2024

KsGateCaptureThreshold 함수는 게이트로 지정된 AND 게이트의 ON 입력을 캡처하는 데 사용됩니다.

구문

BOOLEAN KsGateCaptureThreshold(
  [in] PKSGATE Gate
);

매개 변수

[in] Gate

ON 입력을 동기적으로 캡처할 AND 게이트를 나타내는 KSGATE 구조체에 대한 포인터입니다.

반환 값

AND 게이트가 원래 열려 있는 경우 KsGateCaptureThreshold는 TRUE를 반환합니다. TRUE를 반환하면 다른 스레드가 동시에 게이트를 캡처하고 처리를 시작할 수 없도록 게이트가 닫혔음을 의미합니다.

설명

KsGateCaptureThreshold 는 지정된 AND 게이트의 상태를 확인합니다. 게이트가 열려 있으면 게이트에 대한 입력이 꺼져 게이트가 닫힌 상태로 전환됩니다. 게이트가 닫힌 경우 함수는 아무 것도 수행하지 않습니다. KsGateGetStateUnsafe와 달리 이 호출은 다른 게이트 상태 변경과 관련하여 동기적으로 수행됩니다. 게이트 제어를 기반으로 처리하는 기본 동기화 메커니즘입니다.

이름에도 불구하고 이 함수는 일반적으로 게이트가 아닌 AND 게이트에 대한 유효한 호출일 뿐입니다. 그러나 AVStream은 게이트 가 AND 게이트인지 OR 게이트인지 확인하지 않습니다. 호출이 AND 게이트에서만 수행되도록 하는 것은 호출자의 책임입니다.

이 호출은 연동 함수를 사용하여 이루어지므로 다른 게이트 상태 변경 함수와 관련하여 동기적입니다. 프로세스 제어의 매우 효율적인 방법이기도 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	ks.h(Ks.h 포함)
IRQL	모든 수준