IDDCX_METADATA2-Struktur (iddcx.h)

IDDCX_METADATA2 stellt Informationen zur aktuellen bereitgestellten Oberfläche und zur Anzeige bereit.

Syntax

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

Member

Size

Gesamtgröße der Struktur in Bytes.

ValidFlags

Ein bitweiser OR mit IDDCX_METADATA2_VALID_FLAGS Werten, die angeben, welche Felder in dieser Struktur gültigen Inhalt aufweisen.

PresentationFrameNumber

Präsentationsrahmennummer dieser Oberfläche.

DirtyRectCount

Anzahl der modifiziert Rects für diesen Frame. Rufen Sie IddCxSwapChainGetDirtyRects auf, um die modifiziert Rects abzurufen.

Ein DirtyRectCount von 1, bei dem für das einzelne modifiziert Rect alle Werte auf 0 festgelegt sind, gibt an, dass keine Bildaktualisierungen aus dem vorherigen Frame vorgenommen wurden. In dieser Situation hat der Treiber die Möglichkeit, das Desktopimage erneut zu codieren, um die visuelle Qualität zu erhöhen. Sobald keine weiteren Updates mehr vorhanden sind, stellt das Betriebssystem denselben Frame so oft dar, wie durch den Wert IDDCX_ADAPTER_CAPS::StaticDesktopReencodeFrameCount angegeben, und wird dann bis zum nächsten Update nicht mehr angezeigt.

HwProtectedSurface

Gibt an, ob die bereitgestellte Oberfläche hardwaregeschützter ist.

PresentDisplayQPCTime

System-QPC-Zeit, wann diese Oberfläche auf dem indirekten Anzeigemonitor angezeigt werden soll.

pSurface

Zeiger auf eine IDXGIResource DX-Oberfläche, die das zu codierende und zu übertragende Bild enthält. Der Treiber kann diese DX-Oberfläche jederzeit verwenden, bis IddCxSwapChainReleaseAndAcquire erneut aufgerufen wird.

SurfaceColorSpace

Ein DXGI_COLOR_SPACE_TYPE Wert, der den Farbraum der bereitgestellten Oberfläche angibt. Der Farbraum entspricht in der Regel dem im committen Pfad angegebenen.

SdrWhiteLevel

Der Weißwert in Nissen für alle SDR-Gehalte; Beispielsweise der Mauscursor. Dieser Wert ist für Nicht-HDR-Modi immer auf 80 Nits festgelegt.

SystemBufferInfo

Eine IDDCX_SYSTEM_BUFFER_INFO Struktur, in der die resultierenden Informationen aus dem Release- und Acquire-Vorgang zurückgegeben werden.

Hdr10FrameMetaData

Eine IDDCX_HDR10_FRAME_METADATA Struktur, die die HDR10-Metadaten enthält, die mit diesem Frame verwendet werden sollen.

Hinweise

Weitere Informationen zur HDR-Unterstützung finden Sie unter Updates von IddCx, Version 1.10.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11, Version 22H2 September Update (IddCx Version 1.10)
Kopfzeile iddcx.h

Weitere Informationen

IDARG_OUT_RELEASEANDACQUIREBUFFER2

IddCxSwapChainReleaseAndAcquireBuffer2