structure KSAUTOMATION_TABLE (ks.h)

Article
02/07/2025

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 ce tableau.

PropertySets

Pointeur vers un tableau d’objets KSPROPERTY_SET (PropertySetsCount 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 de jeux de méthodes dans cette table Automation.

MethodItemSize

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

MethodSets

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

EventSetsCount

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

EventItemSize

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

EventSets

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

Alignment

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

Remarques

Notez que chaque objet (épingler, filtrer, nœud de topologie) doit définir une table Automation. Les minidrivers peuvent utiliser des macros définies dans Ks.h pour définir des tables d’automatisation et les tableaux qu’ils 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)
    };

Exigences

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

Voir aussi

Partager via