structure KSALLOCATOR_FRAMING_EX (ks.h)

Article
02/29/2024

La structure KSALLOCATOR_FRAMING_EX est le remplacement d’AVStream pour KSALLOCATOR_FRAMING. KSALLOCATOR_FRAMING_EX définit les exigences d’allocation sur une broche dans un filtre au niveau du noyau.

Syntaxe

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

Membres

CountItems

Spécifie le nombre d’éléments de cadrage présents dans le tableau FramingItem .

PinFlags

Réservé, défini sur zéro.

OutputCompression

Pointe vers une structure de type KS_COMPRESSION qui définit le ratio d’images pour les transformations qui modifient la taille d’une image.

PinWeight

Le poids de ce cadrage de broche à l’échelle du graphique. Réservé, défini sur zéro.

FramingItem[1]

Tableau de structures KS_FRAMING_ITEM spécifiant les éléments de cadrage réels.

Remarques

Un minidriver peut également utiliser DECLARE_SIMPLE_FRAMING_EX pour déclarer une structure de cadrage étendue en ligne avec la structure d’origine. Cette macro est définie dans Ks.h comme suit :

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

DECLARE_SIMPLE_FRAMING_EX déclare une structure KSALLOCATOR_FRAMING_EX appelée FramingExName avec le type de mémoire spécifié (souvent STATIC_KS_TYPE_DONT_CARE ou l’un des GUID paginés ou non paginés du noyau). Les champs Frames et Alignment de la macro correspondent à la KSALLOCATOR_FRAMING. MinFrameSize et MaxFrameSize garantissent que les images se trouvent dans une plage de tailles spécifique. Les indicateurs correspondent aux OptionsFlags et RequirementsFlags dans KSALLOCATOR_FRAMING.