Функция KsGateCaptureThreshold (ks.h)

Статья
02/29/2024

Функция KsGateCaptureThreshold используется для записи входных данных ON для шлюза AND, указанного в параметре Gate.

Синтаксис

BOOLEAN KsGateCaptureThreshold(
  [in] PKSGATE Gate
);

Параметры

[in] Gate

Указатель на структуру KSGATE , представляющую шлюз AND, для которого синхронно записывается вход on.

Возвращаемое значение

KsGateCaptureThreshold возвращает значение TRUE , если шлюз AND был изначально открыт. Обратите внимание, что возврат true подразумевает, что шлюз был закрыт, чтобы ни один другой поток не мог одновременно захватить шлюз и начать обработку.

KsGateCaptureThreshold проверяет состояние заданного шлюза AND. Если шлюз открыт, он отключает входные данные для ворот, тем самым переходя в закрытое состояние. Если шлюз закрыт, функция не выполняет никаких действий. В отличие от KsGateGetStateUnsafe, этот вызов выполняется синхронно в отношении других изменений состояния шлюза. Это основной механизм синхронизации для обработки на основе управления шлюзом.

Несмотря на свое название, эта функция является допустимым вызовом только для вентили AND, но не вентили в целом. Однако AVStream не проверяет, является ли шлюз шлюзом AND или шлюзом OR. Ответственность за то, чтобы звонок был выполнен только на шлюзах AND, отвечает за то, чтобы вызывающий абонент был выполнен.

Вызов выполняется с использованием взаимосвязанных функций и, таким образом, синхронно по отношению к любой другой функции изменения состояния шлюза; это также очень эффективный метод управления процессом.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версий.
Целевая платформа	Персональный компьютер
Верхняя часть	ks.h (включая Ks.h)
IRQL	Любой уровень