struktur KSALLOCATOR_FRAMING_EX (ks.h)

Artikel
02/29/2024

Struktur KSALLOCATOR_FRAMING_EX adalah pengganti AVStream untuk KSALLOCATOR_FRAMING. KSALLOCATOR_FRAMING_EX mendefinisikan persyaratan alokator pada pin dalam filter tingkat kernel.

Sintaks

typedef struct {
  ULONG           CountItems;
  ULONG           PinFlags;
  KS_COMPRESSION  OutputCompression;
  ULONG           PinWeight;
  KS_FRAMING_ITEM FramingItem[1];
} KSALLOCATOR_FRAMING_EX, *PKSALLOCATOR_FRAMING_EX;

Anggota

CountItems

Menentukan jumlah item pembingkaian yang ada dalam array FramingItem .

PinFlags

Dicadangkan, atur ke nol.

OutputCompression

Menunjuk ke struktur jenis KS_COMPRESSION yang menentukan rasio bingkai untuk transformasi yang mengubah ukuran bingkai.

PinWeight

Lebar grafik pembingkaian pin ini. Dicadangkan, atur ke nol.

FramingItem[1]

Array struktur KS_FRAMING_ITEM yang menentukan item pembingkaian aktual.

Keterangan

Minidriver juga dapat menggunakan DECLARE_SIMPLE_FRAMING_EX untuk mendeklarasikan struktur pembingkaian yang diperluas sesuai dengan struktur aslinya. Makro ini didefinisikan dalam Ks.h sebagai berikut:

#define DECLARE_SIMPLE_FRAMING_EX(FramingExName, MemoryType, Flags, Frames, Alignment, MinFrameSize, MaxFrameSize) const KSALLOCATOR_FRAMING_EX FramingExName

DECLARE_SIMPLE_FRAMING_EX mendeklarasikan struktur KSALLOCATOR_FRAMING_EX yang disebut FramingExName dengan jenis memori yang ditentukan (seringkali STATIC_KS_TYPE_DONT_CARE atau salah satu GUID kernel atau GUID yang tidak dipagasi). Bidang Bingkai dan Perataan makro sesuai dengan KSALLOCATOR_FRAMING. MinFrameSize dan MaxFrameSize memastikan bahwa bingkai berada dalam rentang ukuran tertentu. Bendera sesuai dengan OptionsFlags dan RequirementsFlags di KSALLOCATOR_FRAMING.