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) |