struttura DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES (dxgiddi.h)

Articolo
08/07/2023

Utilizzato dal driver di visualizzazione in modalità utente per specificare gli attributi del piano di sovrimpressione.

Sintassi

typedef struct DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES {
  UINT                                           Flags;
  RECT                                           SrcRect;
  RECT                                           DstRect;
  RECT                                           ClipRect;
  DXGI_DDI_MODE_ROTATION                         Rotation;
  DXGI_DDI_MULTIPLANE_OVERLAY_BLEND              Blend;
  UINT                                           DirtyRectCount;
  RECT                                           *pDirtyRects;
  UINT                                           NumFilters;
  void                                           *pFilters;
  DXGI_DDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT VideoFrameFormat;
  UINT                                           YCbCrFlags;
  DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT      StereoFormat;
  BOOL                                           StereoLeftViewFrame0;
  BOOL                                           StereoBaseViewFrame0;
  DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE   StereoFlipMode;
  DXGI_DDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY    StretchQuality;
} DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES;

Members

Flags

Specifica un'operazione di inversione come uno dei valori applicabili nell'enumerazione DXGI_DDI_MULTIPLANE_OVERLAY_FLAGS .

SrcRect

Specifica il rettangolo di origine, di tipo RECT, rispetto alla risorsa di origine.

DstRect

Specifica il rettangolo di destinazione, di tipo RECT, relativo alla risoluzione del monitoraggio.

ClipRect

Specifica eventuali ritagli aggiuntivi, di tipo RECT, rispetto al rettangolo DstRect , dopo che i dati sono stati estesi in base ai valori di SrcRect e DstRect.

Il driver e l'hardware possono usare il membro ClipRect per applicare un fattore di estensione comune quando cambia il ritaglio quando un'app occude parte del rettangolo di destinazione DstRect .

Rotation

Specifica la rotazione in senso orario del piano di sovrimpressione, dato come valore dall'enumerazione DXGI_DDI_MODE_ROTATION .

Blend

Specifica la modalità di fusione applicata a questo piano di sovrapposizione e al piano sottostante, dato come valore dall'enumerazione DXGI_DDI_MULTIPLANE_OVERLAY_BLEND .

DirtyRectCount

Numero di rettangoli dirty specificati per il piano di sovrapposizione. Se zero, l'intero piano viene considerato sporco.

pDirtyRects

Puntatore a una matrice di rettangoli dirty (RECTs), rispetto al rettangolo di origine SrcRect, che indica la parte del piano di sovrimpressione che è stata modificata.

Il driver può usare questo membro per eseguire ottimizzazioni, anche se non è necessario usare le informazioni sul rettangolo dirty. Tuttavia, il driver non deve mai avere esito negativo di una chiamata di funzione in base ai rettangoli dirty forniti.

NumFilters

Facoltativamente, specifica il numero di filtri implementati dal driver e dall'hardware nel piano di sovrimpressione. Si noti che il sistema operativo ignora questo membro.

pFilters

Puntatore facoltativo a un buffer che specifica i filtri implementati dal driver e dall'hardware nel piano di sovrapposizione. Si noti che il sistema operativo ignora questo membro.

VideoFrameFormat

Specifica il formato dei fotogrammi video del piano di sovrimpressione, dato come valore dell'enumerazione DXGI_DDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT .

Nota Questo valore deve essere sempre DXGI_DDI_MULIIPLANE_OVERLAY_VIDEO_FRAME_FORMAT_PROGRESSIVE. Il sistema operativo non supporta gli altri valori di enumerazione.

YCbCrFlags

Specifica l'intervallo YUV e le informazioni di conversione come uno dei valori applicabili nell'enumerazione DXGI_DDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS .

StereoFormat

Specifica il formato dei fotogrammi video del piano di sovrimpressione, dato come valore dell'enumerazione DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT .

Nota Questo valore deve essere sempre DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT_MONO. Il sistema operativo non supporta gli altri valori di enumerazione.

StereoLeftViewFrame0

Riservato per l'utilizzo nel sistema. Deve essere sempre FALSE.

StereoBaseViewFrame0

Riservato per l'utilizzo nel sistema. Deve essere sempre FALSE.

StereoFlipMode

Specifica la modalità di inversione stereo del piano di sovrimpressione, in base al valore dell'enumerazione DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE .

Nota Questo valore deve essere sempre DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_NONE. Il sistema operativo non supporta gli altri valori di enumerazione.

StretchQuality

Specifica la qualità dell'estensione del piano di sovrimpressione, in base al valore dell'enumerazione DXGI_DDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY .