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. Renseigne la valeur Gate -> Count. Pour une nouvelle porte AND, il doit s’agir de 1 (1 - 0 sur les entrées), 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 suivante.

[in] StateToPropagate

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

Valeur de retour

None

Remarques

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

Les portes AND et OR sont des conceptualisations du mécanisme de mise en place. AVStream ne les distingue pas 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 Portes de contrôle de flux dans AVStream, KSGATE.

Configuration requise

Condition requise Valeur
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