KsGateInitialize 函式 (ks.h)
KsGateInitialize 函式會初始化閘道以供使用。
語法
void KsGateInitialize(
[in] PKSGATE Gate,
[in] LONG InitialCount,
[in, optional] PKSGATE NextGate,
[in] BOOLEAN StateToPropagate
);
參數
[in] Gate
要初始化之 KSGATE 結構的指標。
[in] InitialCount
此參數會指定要放在閘道上的初始計數。 填入 Gate -> Count。 對於新的 AND 閘道,這應該是 1 (1 ~ 0 關閉輸入),而對於新的 OR 閘道,這應該是 0 (0 在輸入上)。 如需詳細資訊,請參閱AVStream 中的流量控制閘道。
[in, optional] NextGate
KSGATE 結構的指標,閘道 應該附加其輸出以進行狀態轉換。 如果未指定這個選擇性參數,閘道 就不會附加至後續的閘道。
[in] StateToPropagate
此參數會指定傳播 ON 轉換或 OFF 轉換。 針對 OR 閘道,設定為 TRUE;針對 AND 閘道,設定為 FALSE。
傳回值
沒有
言論
Minidrivers 不應該直接呼叫 KsGateInitialize,而是應該改用 KsGateInitializeAnd 或 KsGateInitializeOr。
AND 和 OR 閘道是管制機制的概念化。 AVStream 不會在通用網關函式的實作中區分它們。 AND 和 OR 閘道專屬的閘道函式是通用閘道函式的內嵌呼叫。
若要深入瞭解 AVStream 中的閘道建構,請參閱 AVStream 中的流量控制閘道,KSGATE。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。 |
目標平臺 | 桌面 |
標頭 | ks.h (包括 Ks.h) |
IRQL | 任何層級 |