D3DDDIARG_VIDEOPROCESSBLT struttura (d3dumddi.h)

Articolo
08/07/2023

La struttura D3DDDIARG_VIDEOPROCESSBLT descrive un'operazione di elaborazione video di Microsoft DirectX Video Acceleration (VA) da eseguire.

Sintassi

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;

Members

[in] TargetFrame

Valore REFERENCE_TIME che identifica la posizione del frame di output all'interno della sequenza di fotogrammi di input. Se viene eseguita solo la denterlacing, l'ora di destinazione deve coincidere con l'ora di visualizzazione iniziale di un campione, come definito dal membro Start nella struttura DXVADDI_VIDEOSAMPLE o dal punto intermedio tra l'ora di visualizzazione iniziale e l'ora di visualizzazione finale.

Se viene richiesta una conversione della frequenza di frame, l'ora in TargetFrame può essere diversa da qualsiasi volta nei membri Start degli esempi.

[in] hVideoProcess

Handle per il dispositivo di elaborazione video DirectX VA. Il driver di visualizzazione in modalità utente restituisce questo handle in una chiamata alla relativa funzione CreateVideoProcessDevice .

[in] TargetRect

Puntatore a una struttura RECT che descrive la posizione all'interno della superficie di destinazione in cui viene scritta l'immagine di output. Si noti che l'immagine di output è limitata ai pixel all'interno del rettangolo a cui punta TargetRect. Ovvero, ogni pixel all'interno di questo rettangolo deve essere scritto in; i pixel esterni a questo rettangolo non devono essere modificati.

[in] ConstrictionSize

Struttura SIZE che specifica, per il contenuto protetto, le dimensioni in cui ridurre l'immagine di output. ConstrictionSize deve essere compreso tra (1, 1) e (larghezza, altezza) del rettangolo di destinazione specificato nel membro TargetRect . ConstrictionSize deve essere (0, 0) per rappresentare nessuna constrizione.

Si consideri ad esempio che il video ha in modo nativo 1920 x 1080 pixel e che viene visualizzato a schermo intero su un monitor a risoluzione 1920 x 1080 per cui la protezione di output non è supportata. Se il contenuto video specifica una regola che può essere visualizzata solo da 854 x 480 pixel di informazioni originali, il driver deve ridurre l'immagine originale da 1920 x 1080 a 854 x 480 e quindi estendere nuovamente l'immagine a 1920 x 1080. In questo esempio la struttura SIZE nel membro ConstrictionSize specifica una dimensione di 854 x 480 pixel.

[in] StreamingFlags

Valore UINT che identifica i flag di streaming. Attualmente non vengono definiti flag di streaming.

[in] BackgroundColor

Struttura DXVADDI_AYUVSAMPLE16 che identifica il colore di sfondo.

[in] DestFormat

Struttura DXVADDI_EXTENDEDFORMAT che identifica le informazioni di formato estese per l'area di destinazione.

[in] DestFlags

Struttura DXVADDI_VIDEOPROCESSBLTFLAGS che identifica le modifiche nell'area di destinazione corrente dall'area di destinazione precedente.

[in] ProcAmpValues

Struttura DXVADDI_PROCAMPVALUES che specifica i dati di regolazione ProcAmp restituiti nell'area di destinazione.

[in] Alpha

Struttura DXVADDI_FIXED32 che specifica il valore di trasparenza planare dell'immagine di output come scritto nell'area di destinazione. Quando il valore alfa è 1,0, il colore di sfondo viene disegnato opaco (senza trasparenza e fusione alfa). Quando il valore alfa è 0,0, lo sfondo non deve essere disegnato (trasparente).

[in] NoiseFilterLuma

Struttura DXVADDI_FILTERVALUES che specifica il filtro di rumore luma.

[in] NoiseFilterChroma

Struttura DXVADDI_FILTERVALUES che specifica il filtro di rumore chroma.

[in] DetailFilterLuma

Struttura DXVADDI_FILTERVALUES che specifica il filtro dei dettagli luma.

[in] DetailFilterChroma

Struttura DXVADDI_FILTERVALUES che specifica il filtro dei dettagli di chroma.

[in] pSrcSurfaces

Matrice di strutture DXVADDI_VIDEOSAMPLE che descrivono gli esempi di input necessari per la denterlacing, la conversione a frequenza di fotogrammi e le operazioni di composizione substream. Per altre informazioni sulla disposizione degli esempi di input in questa matrice, vedere Ordine buffer di input.

[in] NumSrcSurfaces

Numero di esempi di input nella matrice in pSrcSurfaces.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	d3dumddi.h (include D3dumddi.h)