KS_DATARANGE_VIDEO-Struktur (ksmedia.h)

Artikel
02/29/2024

Die KS_DATARANGE_VIDEO-Struktur beschreibt eine Reihe von Videostreams ohne Bob- oder Webeinstellungen.

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;

Member

DataRange

Gibt den Hauptbezeichner für das Format an.

bFixedSizeSamples

Gibt an, dass alle Beispiele dieselbe Größe haben, wenn sie auf TRUE festgelegt sind.

bTemporalCompression

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

StreamDescriptionFlags

Nicht verwendet und sollte auf 0 festgelegt werden.

MemoryAllocationFlags

Nicht verwendet und sollte auf 0 festgelegt werden.

ConfigCaps

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

VideoInfoHeader

Gibt die Details des Videostreams an.

Hinweise

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

Zur Minidriver-Initialisierung gibt der Minidriver ein Array von KS_DATARANGE_VIDEO Strukturen zurück, die alle unterstützten Formate für einen bestimmten Pin verfügbar macht, einschließlich möglicher Zuschneide- und Skalierungsoptionen.
Wenn ein bestimmtes Format von einem Client im Benutzermodus ausgewählt wird, bestimmen die Member (und ihre Einstellungen) dieser Struktur, ob ein vorgeschlagenes Format vom Minidriver unterstützt wird. Benutzermodusclients ändern den Inhalt des VideoInfoHeader-Members , müssen jedoch alle anderen Mitglieder 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 jeweilige angeforderte Format eindeutig sind.

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

Anforderungen

Anforderung	Wert
Header	ksmedia.h (include Ksmedia.h)

Weitere Informationen

KSDATARANGE

KS_VIDEOINFOHEADER

KS_VIDEO_STREAM_CONFIG_CAPS

Freigeben über