KsGateCaptureThreshold 函式 (ks.h)
KsGateCaptureThreshold 函式是用來擷取閘道所指定 AND 閘道的 ON 輸入。
語法
BOOLEAN KsGateCaptureThreshold(
[in] PKSGATE Gate
);
參數
[in] Gate
KSGATE 結構的指標，代表要同步擷取 ON 輸入的 AND 閘道。
傳回值
如果 AND 閘道原本開啟，KsGateCaptureThreshold 會傳回 TRUE。 請注意，傳回 TRUE 表示閘道已關閉，讓其他線程無法同時擷取網關並開始處理。
備註
KsGateCaptureThreshold 會檢查指定 AND 閘道的狀態。 如果閘道已開啟，它會關閉閘道的輸入，藉此將閘道轉換為關閉狀態。 如果閘道已關閉，則函式不會執行任何動作。 不同於 KsGateGetStateUnsafe，此呼叫會隨著其他閘道狀態變更同步完成。 這是根據閘道控制處理的主要同步處理機制。
雖然其名稱，但此函式只是 AND 閘道的有效呼叫，而不是一般閘道。 不過，AVStream 不會驗證閘道是 AND 閘道 還是 OR 閘道。 呼叫者必須負責確保只會在 AND 閘道上進行通話。
呼叫是使用連結函式進行，因此會與任何其他閘道狀態變更函式同步;它也是一種非常有效率的程式控制方法。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX 版本。 |
| 目標平台 | 桌面 |
| 標頭 | ks.h (包含 Ks.h) |
| IRQL | 任何層級 |