структура IDDCX_METADATA2 (iddcx.h)

IDDCX_METADATA2 предоставляет сведения о текущей предоставленной поверхности и о том, что на ней отображается.

Синтаксис

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

Члены

Size

Общий размер структуры в байтах.

ValidFlags

Побитовое ИЛИ IDDCX_METADATA2_VALID_FLAGS значений , указывающих, какие поля в этой структуре имеют допустимое содержимое.

PresentationFrameNumber

Номер кадра презентации этой поверхности.

DirtyRectCount

Число грязное прямоугольников для этого кадра. Вызовите IddCxSwapChainGetDirtyRects, чтобы получить грязное прямоугольники.

Значение DirtyRectCount, равное 1, где один грязное прямоугольник имеет все значения, равные нулю, указывает на то, что из предыдущего кадра не было никаких обновлений изображения. В этом случае драйвер может повторно закодировать изображение рабочего стола, чтобы повысить качество визуализации. После отсутствия обновлений ОС отображает один и тот же кадр столько раз, сколько указано в значении IDDCX_ADAPTER_CAPS::StaticDesktopReencodeFrameCount , а затем прекращает показ до следующего обновления.

HwProtectedSurface

Указывает, защищена ли предоставленная поверхность аппаратной защитой.

PresentDisplayQPCTime

Системное время QPC, когда эта поверхность должна отображаться на мониторе непрямого дисплея.

pSurface

Указатель на поверхность IDXGIResource DX, содержащую изображение для кодирования и передачи. Драйвер может использовать эту поверхность DX в любое время, пока iddCxSwapChainReleaseAndAcquire не будет вызван снова.

SurfaceColorSpace

Значение DXGI_COLOR_SPACE_TYPE , указывающее цветовое пространство предоставленной поверхности. Цветовое пространство обычно совпадает с указанным в зафиксированном пути.

SdrWhiteLevel

Белый уровень в нитах для любого содержимого SDR; например, курсор мыши. Это значение по умолчанию всегда равно 80 нит для режимов, отличных от HDR.

SystemBufferInfo

Структура IDDCX_SYSTEM_BUFFER_INFO , в которой возвращаются результирующая информация из операции освобождения и получения .

Hdr10FrameMetaData

Структура IDDCX_HDR10_FRAME_METADATA , содержащая метаданные HDR10 для использования с этим кадром.

Комментарии

Дополнительные сведения о поддержке HDR см. в разделе Обновления IddCx версии 1.10.

Требования

Требование Значение
Минимальная версия клиента Windows 11, версия 22H2 с обновлением за сентябрь (IddCx версии 1.10)
Верхняя часть iddcx.h

См. также раздел

IDARG_OUT_RELEASEANDACQUIREBUFFER2

IddCxSwapChainReleaseAndAcquireBuffer2