Struktur KSDATAFORMAT (ks.h)

  • Artikel

Struktur KSDATAFORMAT adalah struktur panjang variabel yang menjelaskan format data.

Sintaks

typedef struct {
  ULONG FormatSize;
  ULONG Flags;
  ULONG SampleSize;
  ULONG Reserved;
  GUID  MajorFormat;
  GUID  SubFormat;
  GUID  Specifier;
} KSDATAFORMAT, *PKSDATAFORMAT, KSDATARANGE, *PKSDATARANGE;

Anggota

FormatSize

Menentukan ukuran, dalam byte, dari struktur KSDATAFORMAT. Ini harus setidaknya sizeof(KSDATAFORMAT), tetapi bisa lebih besar untuk pengaturan MajorFormat, SubFormat, dan Specifier tertentu. Lihat deskripsi untuk anggota ini untuk informasi selengkapnya.

Flags

Atur Bendera ke KSDATAFORMAT_ATTRIBUTES (0x2) untuk menunjukkan bahwa KSDATAFORMAT diikuti dalam memori oleh KSMULTIPLE_ITEM struktur KSATTRIBUTE .

SampleSize

Menentukan ukuran sampel data, untuk ukuran sampel tetap, atau nol, jika format memiliki ukuran sampel variabel.

Reserved

Dicadangkan untuk penggunaan sistem. Driver harus mengatur anggota ini ke nol.

MajorFormat

Menentukan jenis format umum. Format data yang saat ini didukung dapat ditemukan dalam konstanta simbolis KSDATAFORMAT_TYPE_XXX dalam file header ksmedia.h yang disertakan dalam Windows Driver Kit (WDK). Aliran data yang tidak memiliki format tertentu harus menggunakan KSDATAFORMAT_TYPE_STREAM (didefinisikan dalam ks.h) sebagai nilai untuk MajorFormat-nya. Untuk informasi selengkapnya tentang anggota ini, lihat Keterangan.

SubFormat

Menentukan subformat tipe format umum. Subformat data yang saat ini didukung dapat ditemukan di konstanta simbolis KSDATAFORMAT_SUBTYPE_XXX dalam file header ksmedia.h yang disertakan dalam WDK. Format utama yang tidak mendukung subformat harus menggunakan nilai KSDATAFORMAT_SUBTYPE_NONE untuk anggota ini. Untuk informasi selengkapnya tentang anggota ini, lihat Keterangan.

Specifier

Menentukan informasi jenis format data tambahan untuk pengaturan MajorFormat dan SubFormat tertentu. Signifikansi bidang ini ditentukan oleh format utama (dan subformat, jika format utama mendukung subformat). Misalnya, Penentu dapat mewakili pengodean subformat tertentu, atau dapat digunakan untuk menentukan jenis struktur data apa yang mengikuti KSDATAFORMAT dalam memori.

Penentu berikut (didefinisikan dalam ks.h) digunakan secara umum:

KSDATAFORMAT_SPECIFIER_NONE

Singkatan tidak ada penentu. Digunakan untuk format yang tidak mendukung penentu.

KSDATAFORMAT_SPECIFIER_FILENAME

Menunjukkan bahwa string Unicode yang dihentikan null segera mengikuti struktur KSDATAFORMAT dalam memori.

KSDATAFORMAT_SPECIFIER_FILEHANDLE

Menunjukkan bahwa handel file segera mengikuti KSDATAFORMAT dalam memori.

Keterangan

Minimal, format data ditentukan oleh Anggota MajorFormat, SubFormat, dan Penentu . Keluarga dengan format data serupa dapat berbagi nilai yang sama untuk MajorFormat, SubFormat, dan Specifier. Dalam hal ini, format data tertentu dibedakan oleh data tambahan yang mengikuti anggota Penentu dalam memori.

Untuk daftar kombinasi MajorFormat, SubFormat, dan Specifier, lihat kategori Stream dan subtopiknya.

Persyaratan

Persyaratan Nilai
Header ks.h (termasuk Ks.h)

Lihat juga

Kategori Stream