struttura KSAUTOMATION_TABLE (ks.h)

Articolo
02/07/2025

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;

Membri

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 delle proprietà in questa tabella.

PropertySets

Puntatore a una matrice di oggetti KSPROPERTY_SET (PropertySetsCount 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 lunghezza) che definisce i set di metodi in questa tabella di automazione. Ogni set include un numero specifico di elementi 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 lunghezza) che definisce i set di eventi in questa tabella di automazione. Ogni set include un numero specifico di elementi di dimensioni EventItemSize.

Alignment

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

Osservazioni

Si noti che ogni oggetto (pin, filtro, nodo della topologia) deve definire una tabella di automazione. I minidriver possono usare macro definite in Ks.h per definire 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

Per esempio:

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

Fabbisogno

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)

Vedere anche

Condividi tramite