共用方式為


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

另請參閱

KsGateAddOffInputToAnd

KsGateAddOffInputToOr

KsGateAddOnInputToAnd

KsGateAddOnInputToOr

KsGateGetStateUnsafe

KsGateInitializeAnd

KsGateInitializeOr

KsGateRemoveOffInputFromAnd

KsGateRemoveOffInputFromOr

KsGateRemoveOnInputFromAnd

KsGateRemoveOnInputFromOr

KsGateTurnInputOff

KsGateTurnInputOn