Функция 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 | Любой уровень |