struktur KSAUTOMATION_TABLE (ks.h)

Artikel
02/26/2024

Struktur KSAUTOMATION_TABLE mendefinisikan struktur yang menggabungkan tabel untuk properti, metode, dan peristiwa.

Sintaks

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;

Anggota

PropertySetsCount

Anggota ini menentukan jumlah set properti dalam tabel otomatisasi ini.

PropertyItemSize

Anggota ini menentukan ukuran dalam byte item properti dalam tabel ini.

PropertySets

Penunjuk ke array objek KSPROPERTY_SET (PropertySetsCount panjangnya) yang menentukan kumpulan properti dalam tabel otomatisasi ini. Setiap set berisi jumlah item tertentu dari ukuran PropertyItemSize.

MethodSetsCount

Anggota ini menentukan jumlah set metode dalam tabel otomatisasi ini.

MethodItemSize

Anggota ini menentukan ukuran dalam byte item metode dalam tabel ini.

MethodSets

Array objek KSMETHOD_SET (MethodSetsCount panjangnya) yang menentukan set metode dalam tabel otomatisasi ini. Setiap set memiliki jumlah item tertentu di dalamnya dengan ukuran MethodItemSize.

EventSetsCount

Anggota ini menentukan jumlah set peristiwa dalam tabel otomatisasi ini.

EventItemSize

Anggota ini menentukan ukuran dalam byte item peristiwa dalam tabel ini.

EventSets

Array objek KSEVENT_SET (EventSetsCount panjangnya) yang menentukan set peristiwa dalam tabel otomatisasi ini. Setiap set memiliki jumlah item tertentu di dalamnya dengan ukuran EventItemSize.

Alignment

Dicadangkan untuk penggunaan internal oleh AVStream. Minidriver tidak boleh memanipulasi anggota ini.

Keterangan

Perhatikan bahwa setiap objek (sematkan, filter, simpul topologi) harus menentukan tabel otomatisasi. Minidriver dapat menggunakan makro yang ditentukan dalam Ks.h untuk menentukan tabel otomatisasi dan array yang dikandungnya:

DEFINE_KSAUTOMATION_TABLE
DEFINE_KSAUTOMATION_PROPERTIES
DEFINE_KSAUTOMATION_METHODS
DEFINE_KSAUTOMATION_EVENTS

Untuk menentukan tabel otomatisasi yang berisi array properti kosong, array peristiwa, atau array metode:

DEFINE_KSAUTOMATION_PROPERTIES_NULL
DEFINE_KSAUTOMATION_METHODS_NULL
DEFINE_KSAUTOMATION_EVENTS_NULL

Contohnya:

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru dan di Microsoft DirectX 8.0 dan versi yang lebih baru.
Header	ks.h (termasuk Ks.h)

Lihat juga