Функция KsGateCaptureThreshold (ks.h)
Функция KsGateCaptureThreshold используется для записи входных данных ON для входных данных AND, указанных Gate.
Синтаксис
BOOLEAN KsGateCaptureThreshold(
[in] PKSGATE Gate
);
Параметры
[in] Gate
Указатель на структуру KSGATE, представляющую шлюз AND, для которого необходимо записать входные данные ON синхронно.
Возвращаемое значение
KsGateCaptureThreshold возвращает TRUE, если ворота И изначально открыты. Обратите внимание, что возврат TRUE подразумевает, что ворота были закрыты, чтобы ни один другой поток не мог одновременно захватить ворота и начать обработку.
Замечания
KsGateCaptureThreshold проверяет состояние заданного И шлюза. Если ворота открыты, он отключает входные данные в ворота, тем самым переходя ворота в закрытое состояние. Если шлюз закрыт, функция ничего не делает. В отличие от KsGateGetStateUnsafe, этот вызов выполняется синхронно в отношении других изменений состояния шлюза. Это основной механизм синхронизации для обработки на основе управления шлюзом.
Несмотря на его имя, эта функция является только допустимым вызовом для шлюзов AND, а не ворот в целом. AvStream, однако, не проверяет, является ли Ворота И воротами ИЛИ. Это ответственность вызывающего, чтобы убедиться, что звонок выполняется только на шлюзах AND.
Вызов выполняется с помощью межблокированных функций и, таким образом, синхронно с учетом любой из других функций изменения состояния шлюза; это также очень эффективный метод управления процессами.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Microsoft Windows XP и более поздних операционных системах и версиях DirectX 8.0 и более поздних версий DirectX. |
| целевая платформа | Настольный |
| заголовка | ks.h (include Ks.h) |
| IRQL | Любой уровень |