KsGateInitialize 函式 (ks.h)

KsGateInitialize 函式會初始化閘道以供使用。

語法

void KsGateInitialize(
  [in]           PKSGATE Gate,
  [in]           LONG    InitialCount,
  [in, optional] PKSGATE NextGate,
  [in]           BOOLEAN StateToPropagate
);

參數

[in] Gate

要初始化之 KSGATE 結構的指標。

[in] InitialCount

此參數會指定要放在閘道上的初始計數。 填入 閘道 -> 計數。 針對新的 AND 閘道，這應該是 1 (1 - 0 off inputs) ，而針對新的 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	任何層級

另請參閱

KsGateInitializeAnd

KsGateInitializeOr

KsGateTerminateAnd

KsGateTerminateOr