struttura DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES (d3dkmddi.h)

Articolo
02/06/2025

Usato dal driver miniport di visualizzazione per specificare gli attributi del piano di sovrimpressione.

Sintassi

typedef struct _DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES {
  DXGK_MULTIPLANE_OVERLAY_FLAGS              Flags;
  RECT                                       SrcRect;
  RECT                                       DstRect;
  RECT                                       ClipRect;
  D3DDDI_ROTATION                            Rotation;
  DXGK_MULTIPLANE_OVERLAY_BLEND              Blend;
  UINT                                       NumFilters;
  void                                       *pFilters;
  DXGK_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT VideoFrameFormat;
  DXGK_MULTIPLANE_OVERLAY_YCbCr_FLAGS        YCbCrFlags;
  DXGK_MULTIPLANE_OVERLAY_STEREO_FORMAT      StereoFormat;
  BOOL                                       StereoLeftViewFrame0;
  BOOL                                       StereoBaseViewFrame0;
  DXGK_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE   StereoFlipMode;
  DXGK_MULTIPLANE_OVERLAY_STRETCH_QUALITY    StretchQuality;
} DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES;

Membri

Flags

Specifica un'operazione di scorrimento come uno dei valori costanti applicabili nell'enumerazione DXGK_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 D3DDDI_ROTATION.

Blend

Specifica la modalità di fusione che si applica a questo piano di sovrapposizione e al piano sottostante, dato come valore dell'enumerazione DXGK_MULTIPLANE_OVERLAY_BLEND.

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 DXGK_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT.

Nota Questo valore deve essere sempre DXGK_MULTIPLANE_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 specificate come valore dall'enumerazione DXGK_MULTIPLANE_OVERLAY_YCbCr_FLAGS.

StereoFormat

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

Nota Questo valore deve essere sempre DXGK_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 capovolgimento stereo del piano di sovrimpressione, in base al valore dell'enumerazione DXGK_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE.

Nota Questo valore deve essere sempre DXGK_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, data come valore dell'enumerazione DXGK_MULTIPLANE_OVERLAY_STRETCH_QUALITY.