KS_DATARANGE_VIDEO structure (ksmedia.h)

Article
02/29/2024

La structure KS_DATARANGE_VIDEO décrit une gamme de flux vidéo sans paramètres bob ou weave.

Syntaxe

typedef struct tagKS_DATARANGE_VIDEO {
  KSDATARANGE                 DataRange;
  BOOL                        bFixedSizeSamples;
  BOOL                        bTemporalCompression;
  DWORD                       StreamDescriptionFlags;
  DWORD                       MemoryAllocationFlags;
  KS_VIDEO_STREAM_CONFIG_CAPS ConfigCaps;
  KS_VIDEOINFOHEADER          VideoInfoHeader;
} KS_DATARANGE_VIDEO, *PKS_DATARANGE_VIDEO;

Membres

DataRange

Spécifie l’identificateur principal du format.

bFixedSizeSamples

Spécifie que tous les échantillons ont la même taille s’ils sont définis sur TRUE.

bTemporalCompression

Spécifie si chaque échantillon peut être autonome, sans s’appuyer sur des échantillons précédents ou futurs.

StreamDescriptionFlags

Non utilisé et doit être défini sur zéro.

MemoryAllocationFlags

Non utilisé et doit être défini sur zéro.

ConfigCaps

Spécifie la configuration du flux, y compris la mise à l’échelle, le rognage, les fréquences de trame et de données.

VideoInfoHeader

Spécifie les détails du flux vidéo.

Remarques

La structure KS_DATARANGE_VIDEO est utilisée à deux fins connexes :

Au moment de l’initialisation du minidriver, le minidriver retourne un tableau de structures KS_DATARANGE_VIDEO qui expose tous les formats pris en charge pour une broche donnée, y compris les options de rognage et de mise à l’échelle possibles.
Lorsqu’un format particulier est sélectionné par un client en mode utilisateur, les membres (et leurs paramètres) de cette structure déterminent si un format proposé est pris en charge par le minidriver. Les clients en mode utilisateur modifient le contenu du membre VideoInfoHeader , mais doivent laisser tous les autres membres de KS_DATARANGE_VIDEO inchangés. Le minidriver vérifie ensuite les paramètres demandés et retourne une structure KS_DATAFORMAT_VIDEO. Le minidriver calcule ensuite les membres qui sont propres au format particulier demandé.

Par exemple, un flux qui prend en charge les formats de capture RGB16, RGB24, YVU9 et JPEG définit un tableau de quatre structures KS_DATAFORMAT_VIDEO.

Configuration requise

Condition requise	Valeur
En-tête	ksmedia.h (incluez Ksmedia.h)

Voir aussi

KSDATARANGE

KS_VIDEOINFOHEADER

KS_VIDEO_STREAM_CONFIG_CAPS

Partager via