D3DDDIARG_VIDEOPROCESSBLT Struktur (d3dumddi.h)

Artikel
02/23/2024

Die D3DDDIARG_VIDEOPROCESSBLT-Struktur beschreibt einen auszuführenden Videoverarbeitungsvorgang von Microsoft DirectX Video Acceleration (VA).

Syntax

typedef struct _D3DDDIARG_VIDEOPROCESSBLT {
  [in] REFERENCE_TIME               TargetFrame;
  [in] HANDLE                       hVideoProcess;
  [in] RECT                         TargetRect;
  [in] SIZE                         ConstrictionSize;
  [in] UINT                         StreamingFlags;
  [in] DXVADDI_AYUVSAMPLE16         BackgroundColor;
  [in] DXVADDI_EXTENDEDFORMAT       DestFormat;
  [in] DXVADDI_VIDEOPROCESSBLTFLAGS DestFlags;
  [in] DXVADDI_PROCAMPVALUES        ProcAmpValues;
  [in] DXVADDI_FIXED32              Alpha;
  [in] DXVADDI_FILTERVALUES         NoiseFilterLuma;
  [in] DXVADDI_FILTERVALUES         NoiseFilterChroma;
  [in] DXVADDI_FILTERVALUES         DetailFilterLuma;
  [in] DXVADDI_FILTERVALUES         DetailFilterChroma;
  [in] DXVADDI_VIDEOSAMPLE          *pSrcSurfaces;
  [in] UINT                         NumSrcSurfaces;
} D3DDDIARG_VIDEOPROCESSBLT;

Member

[in] TargetFrame

Ein REFERENCE_TIME Wert, der die Position des Ausgabeframes innerhalb der Sequenz der Eingabeframes identifiziert. Wenn nur das Deinterlacing ausgeführt wird, sollte die Zielzeit entweder mit der Startanzeigezeit eines Beispiels, wie sie vom Startelement in der DXVADDI_VIDEOSAMPLE-Struktur definiert wird, oder mit dem Mittelpunkt zwischen der Startanzeigezeit und der Endanzeigezeit übereinstimmen.

Wenn eine Konvertierung der Bildfrequenz angefordert wird, kann sich die Zeit in TargetFrame von den Zeiten in den Startelementen der Beispiele unterscheiden.

[in] hVideoProcess

Ein Handle für das DirectX VA-Videoverarbeitungsgerät. Der Benutzermodusanzeigetreiber gibt dieses Handle in einem Aufruf seiner CreateVideoProcessDevice-Funktion zurück.

[in] TargetRect

Ein Zeiger auf eine RECT-Struktur , die die Position auf der Zieloberfläche beschreibt, in die das Ausgabebild geschrieben wird. Beachten Sie, dass das Ausgabebild auf die Pixel innerhalb des Rechtecks beschränkt ist, auf das von TargetRect verwiesen wird. Das heißt, jedes Pixel innerhalb dieses Rechtecks muss geschrieben werden; Pixel außerhalb dieses Rechtecks dürfen nicht geändert werden.

[in] ConstrictionSize

Eine SIZE-Struktur , die für geschützte Inhalte die Größe angibt, auf die das Ausgabebild reduziert werden soll. ConstrictionSize sollte von (1, 1) bis (Breite, Höhe) des Zielrechtecks sein, das im TargetRect-Element angegeben ist. ConstrictionSize sollte (0, 0) sein, um keine Verengung darzustellen.

Beispiel: Video, das nativ über 1920 x 1080 Pixel verfügt und auf einem Monitor mit 1920 x 1080 Auflösung, für den der Ausgabeschutz nicht unterstützt wird, im Vollbildmodus angezeigt wird. Wenn der Videoinhalt eine Regel angibt, dass nur 854 x 480 Pixel originale Informationen angezeigt werden können, muss der Treiber das Originalbild von 1920 x 1080 auf 854 x 480 reduzieren und das Bild dann wieder auf 1920 x 1080 strecken. In diesem Beispiel würde die SIZE-Struktur im Member ConstrictionSize eine Größe von 854 x 480 Pixel angeben.

[in] StreamingFlags

Ein UINT-Wert, der Streamingflags identifiziert. Derzeit sind keine Streamingflags definiert.

[in] BackgroundColor

Eine DXVADDI_AYUVSAMPLE16 Struktur, die Hintergrundfarbe identifiziert.

[in] DestFormat

Eine DXVADDI_EXTENDEDFORMAT-Struktur , die erweiterte Formatinformationen für die Zieloberfläche identifiziert.

[in] DestFlags

Eine DXVADDI_VIDEOPROCESSBLTFLAGS-Struktur , die Änderungen an der aktuellen Zieloberfläche gegenüber der vorherigen Zieloberfläche identifiziert.

[in] ProcAmpValues

Eine DXVADDI_PROCAMPVALUES-Struktur , die ProcAmp-Anpassungsdaten angibt, die an die Zieloberfläche ausgegeben werden.

[in] Alpha

Eine DXVADDI_FIXED32-Struktur , die den Wert der planaren Transparenz des Ausgabebilds angibt, wenn es auf die Zieloberfläche geschrieben wird. Wenn der Alphawert 1,0 ist, wird die Hintergrundfarbe undurchsichtig (ohne Transparenz und Alphamischung) gezeichnet. Wenn der Alphawert 0,0 ist, sollte der Hintergrund nicht (transparent) gezeichnet werden.

[in] NoiseFilterLuma

Eine DXVADDI_FILTERVALUES-Struktur , die den Luma-Rauschfilter angibt.

[in] NoiseFilterChroma

Eine DXVADDI_FILTERVALUES-Struktur , die den Chromarauschfilter angibt.

[in] DetailFilterLuma

Eine DXVADDI_FILTERVALUES-Struktur , die den Luma-Detailfilter angibt.

[in] DetailFilterChroma

Eine DXVADDI_FILTERVALUES Struktur, die den Chroma-Detailfilter angibt.

[in] pSrcSurfaces

Ein Array von DXVADDI_VIDEOSAMPLE Strukturen, die die Eingabebeispiele beschreiben, die für die Vorgänge Deinterlacing, Frameratekonvertierung und Substreamkomositing erforderlich sind. Weitere Informationen zur Anordnung von Eingabebeispielen in diesem Array finden Sie unter Eingabepufferreihenfolge.

[in] NumSrcSurfaces

Die Anzahl der Eingabebeispiele im Array bei pSrcSurfaces.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	d3dumddi.h (include D3dumddi.h)