KsGateInitialize, fonction (ks.h)

Article
07/02/2025

La fonction KsGateInitialize initialise une porte à utiliser.

Syntaxe

C++

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 porte -> Count. Pour une nouvelle porte AND, il doit s’agir de 1 (1 − 0 entrées désactivées) et d’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 des transitions ON ou OFF. Pour une porte OR, définie sur TRUE; pour une porte AND, définie sur FALSE.

Valeur de retour

Aucun

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 elles 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 courantes de porte.

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

Exigences

Exigence	Valeur
client minimum 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	Bureau
d’en-tête	ks.h (include Ks.h)
IRQL	N’importe quel niveau