KsGateCaptureThreshold 函式 (ks.h)

發行項
03/01/2024

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	任何層級