Função KsGateInitialize (ks.h)

A função KsGateInitialize inicializa um portão para uso.

Sintaxe

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

Parâmetros

[in] Gate

Um ponteiro para a estrutura KSGATE a ser inicializada.

[in] InitialCount

Esse parâmetro especifica a contagem inicial a ser colocada no portão. Preenche Portão –> Contagem. Para um novo portão AND, isso deve ser 1 (1 – 0 entradas desativadas) e, para um novo portão OR, isso deve ser 0 (0 em entradas). Para obter mais informações, consulte Portões de controle de fluxo no AVStream.

[in, optional] NextGate

Um ponteiro para uma estrutura KSGATE à qual o Gate deve anexar sua saída para transições de estado. Se esse parâmetro opcional não for especificado, Gate não será anexado a um portão subsequente.

[in] StateToPropagate

Esse parâmetro especifica se as transições ON ou OFF devem ser propagadas. Para um portão OR, defina como TRUE; para um portão AND, definido como FALSE.

Retornar valor

Nenhum

Comentários

Os minidrivers não devem chamar KsGateInitialize diretamente, mas devem usar KsGateInitializeAnd ou KsGateInitializeOr.

As portas AND e OR são conceituações do mecanismo de gating. O AVStream não distingue entre eles na implementação das funções comuns de portão. As funções de portão específicas dos portões AND e OR são chamadas embutidas para as funções comuns de portão.

Para saber mais sobre o constructo de portão no AVStream, confira Portões de controle de fluxo no AVStream, KSGATE.

Requisitos

Confira também

KsGateInitializeAnd

KsGateInitializeOr

KsGateTerminateAnd

KsGateTerminateOr