DXVA_VideoSample2-Struktur (dxva.h)

Artikel
08/07/2023

Die DXVA_VideoSample2-Struktur wird vom Renderer an den Treiber gesendet, um das Format eines Videobeispiels anzugeben.

Syntax

typedef struct _DXVA_VideoSample2 {
  DWORD            Size;
  DWORD            Reserved;
  REFERENCE_TIME   rtStart;
  REFERENCE_TIME   rtEnd;
  DWORD            SampleFormat;
  DWORD            SampleFlags;
  VOID             *lpDDSSrcSurface;
  RECT             rcSrc;
  RECT             rcDst;
  DXVA_AYUVsample2 Palette[16];
} DXVA_VideoSample2, *LPDXVA_VideoSample2;

Member

Size

Kompiliert nur für eine 64-Bit-Version des Betriebssystems.

Gibt die Größe dieser Struktur an.

Reserved

Kompiliert nur für eine 64-Bit-Version des Betriebssystems.

Reserviert.

rtStart

Gibt die Startzeit des Beispiels an.

rtEnd

Gibt die Endzeit des Beispiels an.

SampleFormat

Gibt das Format des Beispiels an, das durch Werte des DXVA_ExtendedFormat Enumerationstyps definiert wird.

SampleFlags

Gibt eine Auflistung von Flags an, die Änderungen im aktuellen Beispielframe gegenüber dem vorherigen Beispielframe angeben. Dieser Member ist ein bitweises OR eines oder mehrerer Flags im DXVA_SampleFlags Enumerationstyp.

lpDDSSrcSurface

Zeiger auf eine DD_SURFACE_LOCAL Struktur, die das Beispiel darstellt.

rcSrc

Gibt eine RECT-Struktur an, die die oberen linken und unteren rechten Punkte eines Rechtecks auf der Quelloberfläche beschreibt. Diese Punkte definieren den Bereich der Quelldaten für die Bitblockübertragung und deren Position auf der Quelloberfläche.

rcDst

Gibt eine RECT-Struktur an, die die oberen linken und unteren rechten Punkte eines Rechtecks auf der Zieloberfläche beschreibt. Diese Punkte definieren den Bereich, in dem die Bitblockübertragung erfolgen soll, und deren Position auf der Zieloberfläche.

Palette[16]

Gibt ein Array von DXVA_AYUVsample2 Strukturen an, die eine vollständige 16-Farbpalette für palettierte Video-Substream-Pixelformate darstellen. Der Treiber verwendet diese Palette, um das Teilstrombeispiel zu zusammengesetzt. Bei nichtpalletisierten Pixelformaten ist die Palette null und kann ignoriert werden.

Hinweise

Bei Videounterstreambeispielen sind die Elemente rtStart und rtEnd auf 0 festgelegt.

Das SampleFormat-Element gibt an, ob das Beispiel ein Verweis für einen Deinterlace-Vorgang oder ein Videounterstreambeispiel ist, das mit dem deinterlaced Videoframe kombiniert werden muss. Der DXVA_SampleSubStream-Wert (neu für Windows Server 2003 mit SP1 und höher und Windows XP mit SP2 und höher) des DXVA_SampleFormat-Enumerationstyps gibt das Format für ein Videounterstreambeispiel an.

Das SampleFlags-Element enthält eine Auflistung von Flags, die auf Änderungen im aktuellen Beispielframe gegenüber dem vorherigen Beispielframe hinweisen. Sie können diese Flags verwenden, um Ihren Treibercode zu optimieren. Anders ausgedrückt: Ihr Code ist nicht erforderlich, um Vorgänge für den aktuellen Beispielframe auszuführen, wenn keine Änderungen aus dem vorherigen Beispielframe vorgenommen wurden.

Informationen dazu, wie Eingabebeispiele im Array im Source-Member der DXVA_DeinterlaceBltEx-Struktur angeordnet werden, finden Sie unter Eingabepufferreihenfolge.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Diese Struktur gilt nur für Windows Server 2003 mit SP1 und höher und Windows XP mit SP2 und höher.
Kopfzeile	dxva.h (dxva.h einschließen)