KS_DATARANGE_VIDEO Struktur (ksmedia.h)

Artikel
02/07/2025

Die KS_DATARANGE_VIDEO-Struktur beschreibt einen Bereich von Videostreams ohne Bob- oder Weave-Einstellungen.

Syntax

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;

Angehörige

DataRange

Gibt den Hauptbezeichner für das Format an.

bFixedSizeSamples

Gibt an, dass alle Beispiele die gleiche Größe aufweisen, wenn sie auf TRUE-festgelegt ist.

bTemporalCompression

Gibt an, ob jedes Beispiel unabhängig voneinander stehen kann, ohne sich auf vorherige oder zukünftige Proben zu verlassen.

StreamDescriptionFlags

Nicht verwendet und sollte auf Null festgelegt werden.

MemoryAllocationFlags

Nicht verwendet und sollte auf Null festgelegt werden.

ConfigCaps

Gibt die Konfiguration des Datenstroms an, einschließlich Skalierung, Zuschneiden und Frame- und Datenraten.

VideoInfoHeader

Gibt die Details des Videostreams an.

Bemerkungen

Die KS_DATARANGE_VIDEO-Struktur wird für zwei verwandte Zwecke verwendet:

Zur Minidriver-Initialisierungszeit gibt der Minidriver ein Array von KS_DATARANGE_VIDEO Strukturen zurück, die alle unterstützten Formate für einen bestimmten Pin verfügbar gemacht haben, einschließlich möglicher Zuschneide- und Skalierungsoptionen.
Wenn ein bestimmtes Format von einem Benutzermodusclient ausgewählt wird, bestimmen die Member (und deren Einstellungen) dieser Struktur, ob ein vorgeschlagenes Format vom Minidriver unterstützt wird. Benutzermodusclients ändern den Inhalt des VideoInfoHeader- Mitglieds, müssen jedoch alle anderen Member von KS_DATARANGE_VIDEO unverändert lassen. Der Minidriver überprüft dann die angeforderten Parameter und gibt eine KS_DATAFORMAT_VIDEO Struktur zurück. Der Minidriver berechnet dann Elemente, die für das gewünschte Format eindeutig sind.

Beispielsweise definiert ein Datenstrom, der RGB16-, RGB24-, YVU9- und JPEG-Aufnahmeformate unterstützt, ein Array von vier KS_DATAFORMAT_VIDEO Strukturen.

Anforderungen

Anforderung	Wert
Header-	ksmedia.h (enthalten Ksmedia.h)

Siehe auch

KSDATARANGE-

KS_VIDEOINFOHEADER

KS_VIDEO_STREAM_CONFIG_CAPS

Freigeben über