KSALLOCATOR_FRAMING_EX-Struktur (ks.h)

Artikel
02/29/2024

Die KSALLOCATOR_FRAMING_EX-Struktur ist der AVStream-Ersatz für KSALLOCATOR_FRAMING. KSALLOCATOR_FRAMING_EX definiert Zuweisungsanforderungen für einen Pin in einem Filter auf Kernelebene.

Syntax

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

Member

CountItems

Gibt die Anzahl der Framingelemente an, die im FramingItem-Array vorhanden sind.

PinFlags

Reserviert, auf Null festgelegt.

OutputCompression

Zeigt auf eine Struktur vom Typ KS_COMPRESSION , die das Frameverhältnis für Transformationen definiert, die die Größe eines Frames ändern.

PinWeight

Das Gewichtsdiagramm dieses Pinrahmens ist breit. Reserviert, auf Null festgelegt.

FramingItem[1]

Ein Array von KS_FRAMING_ITEM Strukturen, die die tatsächlichen Rahmenelemente angeben.

Hinweise

Ein Minidriver kann auch DECLARE_SIMPLE_FRAMING_EX verwenden, um eine erweiterte Rahmenstruktur gemäß der ursprünglichen Struktur zu deklarieren. Dieses Makro wird in Ks.h wie folgt definiert:

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

DECLARE_SIMPLE_FRAMING_EX deklariert eine KSALLOCATOR_FRAMING_EX Struktur namens FramingExName mit dem angegebenen Arbeitsspeichertyp (häufig entweder STATIC_KS_TYPE_DONT_CARE oder eine der kernelseitigen oder nicht ausgelagerten GUIDs). Die Felder Frames und Ausrichtung des Makros entsprechen dem KSALLOCATOR_FRAMING. MinFrameSize und MaxFrameSize stellen sicher, dass sich Frames innerhalb eines bestimmten Größenbereichs befinden. Flags entsprechen den OptionsFlags und RequirementsFlags in KSALLOCATOR_FRAMING.