struttura KSAUTOMATION_TABLE (ks.h)

Articolo
08/07/2023

La struttura KSAUTOMATION_TABLE definisce una struttura che combina tabelle per proprietà, metodi ed eventi.

Sintassi

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;

Members

PropertySetsCount

Questo membro specifica il numero di set di proprietà in questa tabella di automazione.

PropertyItemSize

Questo membro specifica le dimensioni in byte degli elementi della proprietà in questa tabella.

PropertySets

Puntatore a una matrice di oggetti KSPROPERTY_SET (PropertySetsCount in lunghezza) che definisce i set di proprietà in questa tabella di automazione. Ogni set contiene un numero specifico di elementi di dimensioni PropertyItemSize.

MethodSetsCount

Questo membro specifica il numero di set di metodi in questa tabella di automazione.

MethodItemSize

Questo membro specifica le dimensioni in byte degli elementi del metodo in questa tabella.

MethodSets

Matrice di oggetti KSMETHOD_SET (MethodSetsCount in lunghezza) che definisce i set di metodi in questa tabella di automazione. Ogni set ha un numero specifico di elementi in esso di dimensioni MethodItemSize.

EventSetsCount

Questo membro specifica il numero di set di eventi in questa tabella di automazione.

EventItemSize

Questo membro specifica le dimensioni in byte degli elementi dell'evento in questa tabella.

EventSets

Matrice di oggetti KSEVENT_SET (EventSetsCount in lunghezza) che definisce i set di eventi in questa tabella di automazione. Ogni set ha un numero specifico di elementi in esso di dimensioni EventItemSize.

Alignment

Riservato per l'uso interno da AVStream. I minidriver non devono modificare questo membro.

Commenti

Si noti che ogni oggetto (pin, filtro, nodo topologia) deve definire una tabella di automazione. I minidriver possono usare macro definite in Ks.h per definire le tabelle di automazione e le matrici che contengono:

DEFINE_KSAUTOMATION_TABLE
DEFINE_KSAUTOMATION_PROPERTIES
DEFINE_KSAUTOMATION_METHODS
DEFINE_KSAUTOMATION_EVENTS

Per specificare una tabella di automazione contenente una matrice di proprietà vuota, una matrice di eventi o una matrice di metodi:

DEFINE_KSAUTOMATION_PROPERTIES_NULL
DEFINE_KSAUTOMATION_METHODS_NULL
DEFINE_KSAUTOMATION_EVENTS_NULL

Ad esempio:

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

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in Microsoft DirectX 8.0 e versioni successive.
Intestazione	ks.h (include Ks.h)