estrutura KSAUTOMATION_TABLE (ks.h)

A estrutura KSAUTOMATION_TABLE define uma estrutura que combina tabelas para propriedades, métodos e eventos.

Sintaxe

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;

Membros

PropertySetsCount

Esse membro especifica o número de conjuntos de propriedades nesta tabela de automação.

PropertyItemSize

Esse membro especifica o tamanho em bytes de itens de propriedade nesta tabela.

PropertySets

Um ponteiro para uma matriz de objetos KSPROPERTY_SET (PropertySetsCount de comprimento) definindo os conjuntos de propriedades nesta tabela de automação. Cada conjunto contém um número específico de itens de tamanho PropertyItemSize.

MethodSetsCount

Esse membro especifica o número de conjuntos de métodos nesta tabela de automação.

MethodItemSize

Esse membro especifica o tamanho em bytes de itens de método nesta tabela.

MethodSets

Uma matriz de objetos KSMETHOD_SET (MethodSetsCount em comprimento) definindo os conjuntos de métodos nesta tabela de automação. Cada conjunto tem um número específico de itens de tamanho MethodItemSize.

EventSetsCount

Esse membro especifica o número de conjuntos de eventos nesta tabela de automação.

EventItemSize

Esse membro especifica o tamanho em bytes de itens de evento nesta tabela.

EventSets

Uma matriz de objetos KSEVENT_SET (EventSetsCount de comprimento) definindo os conjuntos de eventos nesta tabela de automação. Cada conjunto tem um número específico de itens de tamanho EventItemSize.

Alignment

Reservado para uso interno pelo AVStream. Minidrivers não devem manipular esse membro.

Comentários

Observe que cada objeto (fixar, filtrar, nó de topologia) deve definir uma tabela de automação. Os minidrivers podem usar macros definidas em Ks.h para definir tabelas de automação e as matrizes que elas contêm:

• DEFINE_KSAUTOMATION_TABLE

• DEFINE_KSAUTOMATION_PROPERTIES

• DEFINE_KSAUTOMATION_METHODS

• DEFINE_KSAUTOMATION_EVENTS

Para especificar uma tabela de automação que contém uma matriz de propriedades vazia, uma matriz de eventos ou uma matriz de métodos:

• DEFINE_KSAUTOMATION_PROPERTIES_NULL

• DEFINE_KSAUTOMATION_METHODS_NULL

• DEFINE_KSAUTOMATION_EVENTS_NULL

Por exemplo:

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no Microsoft DirectX 8.0 e versões posteriores.
Cabeçalho	ks.h (inclua Ks.h)

Confira também

KSEVENT_ITEM

KSEVENT_SET

KSMETHOD_ITEM

KSMETHOD_SET

KSPROPERTY_ITEM

KSPROPERTY_SET