structure KSAUTOMATION_TABLE (ks.h)

Article
02/26/2024

La structure KSAUTOMATION_TABLE définit une structure qui combine des tables pour les propriétés, les méthodes et les événements.

Syntaxe

typedef struct KSAUTOMATION_TABLE_ {
  ULONG                PropertySetsCount;
  ULONG                PropertyItemSize;
  const KSPROPERTY_SET *PropertySets;
  ULONG                MethodSetsCount;
  ULONG                MethodItemSize;
  const KSMETHOD_SET   *MethodSets;
  ULONG                EventSetsCount;
  ULONG                EventItemSize;
  const KSEVENT_SET    *EventSets;
  PVOID                Alignment;
} KSAUTOMATION_TABLE, *PKSAUTOMATION_TABLE;

Membres

PropertySetsCount

Ce membre spécifie le nombre de jeux de propriétés dans cette table Automation.

PropertyItemSize

Ce membre spécifie la taille en octets des éléments de propriété de cette table.

PropertySets

Pointeur vers un tableau d’objets KSPROPERTY_SET (PropertySetsCount en longueur) définissant les jeux de propriétés dans cette table Automation. Chaque jeu contient un nombre spécifique d’éléments de taille PropertyItemSize.

MethodSetsCount

Ce membre spécifie le nombre d’ensembles de méthodes dans cette table Automation.

MethodItemSize

Ce membre spécifie la taille en octets des éléments de méthode de cette table.

MethodSets

Tableau d’objets KSMETHOD_SET (MethodSetsCount en longueur) définissant les jeux de méthodes dans cette table Automation. Chaque jeu comporte un nombre spécifique d’éléments de taille MethodItemSize.

EventSetsCount

Ce membre spécifie le nombre de jeux d’événements dans cette table Automation.

EventItemSize

Ce membre spécifie la taille en octets des éléments d’événement de cette table.

EventSets

Tableau d’objets KSEVENT_SET (EventSetsCount en longueur) définissant les jeux d’événements dans cette table Automation. Chaque jeu comporte un nombre spécifique d’éléments de taille EventItemSize.

Alignment

Réservé à une utilisation interne par AVStream. Les minidrivers ne doivent pas manipuler ce membre.

Remarques

Notez que chaque objet (épingle, filtre, nœud de topologie) doit définir une table Automation. Les minidrivers peuvent utiliser des macros définies dans Ks.h pour définir les tables Automation et les tableaux qu’elles contiennent :

DEFINE_KSAUTOMATION_TABLE
DEFINE_KSAUTOMATION_PROPERTIES
DEFINE_KSAUTOMATION_METHODS
DEFINE_KSAUTOMATION_EVENTS

Pour spécifier une table Automation contenant un tableau de propriétés vide, un tableau d’événements ou un tableau de méthodes :

DEFINE_KSAUTOMATION_PROPERTIES_NULL
DEFINE_KSAUTOMATION_METHODS_NULL
DEFINE_KSAUTOMATION_EVENTS_NULL

Par exemple :

DEFINE_KSAUTOMATION_TABLE (MyAutomationTable) {
    DEFINE_KSAUTOMATION_PROPERTIES (MyPropertyTable),
    DEFINE_KSAUTOMATION_METHODS (MyMethodTable),
    DEFINE_KSAUTOMATION_EVENTS (MyEventTable)
    };

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et dans Microsoft DirectX 8.0 et versions ultérieures.
En-tête	ks.h (inclure Ks.h)

Voir aussi

Partager via