KsGateInitialize, fonction (ks.h)

La fonction KsGateInitialize initialise une porte à utiliser.

Syntaxe

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

Paramètres

[in] Gate

Pointeur vers la structure KSGATE à initialiser.

[in] InitialCount

Ce paramètre spécifie le nombre initial à placer sur la porte. Remplit la porte -> Nombre. Pour une nouvelle porte AND, il doit s’agir de 1 (1 − 0 entrées hors), et pour une nouvelle porte OR, il doit s’agir de 0 (0 sur les entrées). Pour plus d’informations, consultez Portes de contrôle de flux dans AVStream.

[in, optional] NextGate

Pointeur vers une structure KSGATE à laquelle Gate doit attacher sa sortie pour les transitions d’état. Si ce paramètre facultatif n’est pas spécifié, Gate n’est pas attaché à une porte ultérieure.

[in] StateToPropagate

Ce paramètre spécifie s’il faut propager les transitions ON ou OFF. Pour une porte OR, définie sur TRUE ; pour une porte AND, définie sur FALSE.

Valeur de retour

None

Remarques

Les minidrivers ne doivent pas appeler KsGateInitialize directement, mais doivent utiliser KsGateInitializeAnd ou KsGateInitializeOr.

Les portes AND et OR sont des conceptualisations du mécanisme de gating. AVStream ne fait pas la distinction entre eux dans l’implémentation des fonctions de porte courantes. Les fonctions de porte spécifiques aux portes AND et OR sont des appels inline aux fonctions de porte courantes.

Pour en savoir plus sur la construction de la porte dans AVStream, consultez Les portes de contrôle de flux dans AVStream, KSGATE.

Spécifications

   
Client minimal pris en charge Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX.
Plateforme cible Desktop (Expérience utilisateur)
En-tête ks.h (inclure Ks.h)
IRQL N’importe quel niveau

Voir aussi

KsGateInitializeAnd

KsGateInitializeOr

KsGateTerminateAnd

KsGateTerminateOr