struttura DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES (dxgiddi.h)

Articolo
02/06/2025

Usato 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;

Membri

Flags

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

SrcRect

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

DstRect

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

ClipRect

Specifica qualsiasi ritaglio aggiuntivo, 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 un'app occude parte del rettangolo di destinazione DstRect.

Rotation

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

Blend

Specifica la modalità di fusione che si applica a questo piano di sovrapposizione e al piano sottostante, dato come valore dell'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 indicano la parte del piano di sovrimpressione modificato.

Il driver può usare questo membro per eseguire ottimizzazioni, anche se non è necessario usare le informazioni sul rettangolo dirty. Tuttavia, il driver non dovrebbe 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 sovrimpressione. 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 le informazioni di conversione e intervallo YUV come uno dei valori applicabili nell'enumerazione DXGI_DDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS.

StereoFormat

Specifica il formato del fotogramma 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'uso del sistema. Deve essere sempre FALSE.

StereoBaseViewFrame0

Riservato per l'uso del sistema. Deve essere sempre FALSE.

StereoFlipMode

Specifica la modalità di scorrimento 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 sovrapposizione, data come valore dell'enumerazione DXGI_DDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY.