Функция 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 от входов), а для нового шлюза ИЛИ — 0 (0 для входов). Дополнительные сведения см. в разделе Шлюзы управления потоком в AVStream.

[in, optional] NextGate

Указатель на структуру KSGATE , к которой шлюз должен присоединять свои выходные данные для переходов состояния. Если этот необязательный параметр не указан, шлюз не присоединяется к последующему шлюзу.

[in] StateToPropagate

Этот параметр указывает, следует ли распространять переходы ON или OFF. Для вентили ИЛИ задайте значение TRUE; для вентили AND установите значение FALSE.

Возвращаемое значение

None

Remarks

Мини-драйверы не должны вызывать KsGateInitialize напрямую, а использовать KsGateInitializeAnd или KsGateInitializeOr.

Вентили AND и OR представляют собой концепцию механизма шлюза. AVStream не различает их в реализации общих функций шлюза. Функции шлюзов, относящиеся к шлюзам AND и OR, являются встроенными вызовами общих функций шлюзов.

Дополнительные сведения о конструкции шлюза в AVStream см. в статье Шлюзы управления потоком в AVStream, KSGATE.

Требования

Требование Значение
Минимальная версия клиента Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версий.
Целевая платформа Персональный компьютер
Верхняя часть ks.h (включая Ks.h)
IRQL Любой уровень

См. также раздел

KsGateInitializeAnd

KsGateInitializeOr

KsGateTerminateAnd

KsGateTerminateOr