KsGateCaptureThreshold 函式 (ks.h)
KsGateCaptureThreshold 函式可用來擷取由 Gate所指定 AND 閘道的 ON 輸入。
語法
BOOLEAN KsGateCaptureThreshold(
[in] PKSGATE Gate
);
參數
[in] Gate
KSGATE 結構的指標,代表要同步擷取 ON 輸入的 AND 閘道。
傳回值
KsGateCaptureThreshold 如果 AND 閘道原本開啟,則會傳 回 true。 請注意,傳回 TRUE 表示閘道已關閉,讓其他線程無法同時擷取閘道並開始處理。
言論
KsGateCaptureThreshold 會檢查指定 AND 閘道的狀態。 如果閘道已開啟,則會關閉閘道的輸入,進而將閘道轉換為封閉狀態。 如果閘道已關閉,則函式不會執行任何動作。 不同於 KsGateGetStateUnsafe,此呼叫會與其他閘道狀態變更同步完成。 這是根據閘道控制處理的主要同步處理機制。
儘管其名稱,但此函式只是 AND 閘道的有效呼叫,而不是一般閘道。 不過,AVStream 不會驗證 閘道 是 AND 閘道還是 OR 閘道。 這是來電者的責任,以確保通話只在AND大門上進行。
呼叫是使用相互鎖定的函式進行,因此會與任何其他閘道狀態變更函式同步;這也是一個非常有效率的程式控制方法。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。 |
目標平臺 | 桌面 |
標頭 | ks.h (包括 Ks.h) |
IRQL | 任何層級 |