Partager via


structure IDDCX_METADATA2 (iddcx.h)

IDDCX_METADATA2 fournit des informations sur la surface fournie actuelle et ce qui est affiché sur celui-ci.

Syntaxe

struct IDDCX_METADATA2 {
  UINT                        Size;
  IDDCX_METADATA2_VALID_FLAGS ValidFlags;
  UINT                        PresentationFrameNumber;
  UINT                        DirtyRectCount;
  BOOL                        HwProtectedSurface;
  UINT64                      PresentDisplayQPCTime;
  IDXGIResource               *pSurface;
  DXGI_COLOR_SPACE_TYPE       SurfaceColorSpace;
  UINT                        SdrWhiteLevel;
  IDDCX_SYSTEM_BUFFER_INFO    SystemBufferInfo;
  IDDCX_HDR10_FRAME_METADATA  Hdr10FrameMetaData;
};

Membres

Size

Taille totale de la structure, en octets.

ValidFlags

Or au niveau du bit des valeurs IDDCX_METADATA2_VALID_FLAGS qui indiquent les champs de cette structure ont du contenu valide.

PresentationFrameNumber

Nombre d’images de présentation de cette surface.

DirtyRectCount

Nombre de rects sales pour ce frame. Appelez IddCxSwapChainGetDirtyRects pour obtenir les rects sales.

Un DirtyRectCount de 1, où le rect sale unique a toutes les valeurs définies sur zéro, indique qu’aucune mise à jour d’image n’a été effectuée à partir du cadre précédent. Dans ce cas, le pilote a la possibilité de réencoder l’image de bureau pour augmenter la qualité visuelle. Une fois qu’il n’y a plus de mises à jour, le système d’exploitation présente le même frame que plusieurs fois comme indiqué par la valeur IDDCX_ADAPTER_CAPS ::StaticDesktopReencodeFrameCount, puis cesse de présenter jusqu’à la prochaine mise à jour.

HwProtectedSurface

Indique si la surface fournie est protégée par le matériel.

PresentDisplayQPCTime

Heure QPC système du moment où cette surface doit être affichée sur le moniteur d’affichage indirect.

pSurface

Pointeur vers une IDXGIResource surface DX qui contient l’image à encoder et à transmettre. Le pilote peut utiliser cette surface DX à tout moment jusqu’à ce que IddCxSwapChainReleaseAndAcquire soit appelée à nouveau.

SurfaceColorSpace

Valeur DXGI_COLOR_SPACE_TYPE qui indique l’espace de couleur de la surface fournie. L’espace de couleur correspond généralement à celui spécifié dans le chemin d’accès validé.

SdrWhiteLevel

Niveau blanc dans les nits pour tout contenu SDR ; par exemple, le curseur de la souris. Cette valeur est toujours de 80 nits pour les modes non HDR.

SystemBufferInfo

Structure IDDCX_SYSTEM_BUFFER_INFO dans laquelle les informations résultantes de la mise en production et l’opération d’acquisition sont retournées.

Hdr10FrameMetaData

Structure IDDCX_HDR10_FRAME_METADATA qui contient les métadonnées HDR10 à utiliser avec ce cadre.

Remarques

Pour plus d’informations sur la prise en charge HDR, consultez mises à jour IddCx version 1.10.

Exigences

Exigence Valeur
client minimum pris en charge Mise à jour de septembre de Windows 11 version 22H2 (IddCx version 1.10)
d’en-tête iddcx.h

Voir aussi

IDARG_OUT_RELEASEANDACQUIREBUFFER2

IddCxSwapChainReleaseAndAcquireBuffer2