Edit

IDDCX_METADATA structure (iddcx.h)

  • Article

IDDCX_METADATA provides information about the current provided surface and what is displayed on it.

Syntax

struct IDDCX_METADATA {
  UINT          Size;
  UINT          PresentationFrameNumber;
  UINT          DirtyRectCount;
  UINT          MoveRegionCount;
  BOOL          HwProtectedSurface;
  UINT64        PresentDisplayQPCTime;
  IDXGIResource *pSurface;
};

Members

Size

Total size of the structure, in bytes.

PresentationFrameNumber

Presentation frame number of this surface.

DirtyRectCount

Number of dirty rects for this frame. Call IddCxSwapChainGetDirtyRects to get the dirty rects.

A MoveRegionCount of zero and DirtyRectCount of 1, where the single dirty rect has all values set to zero, indicates that there has not been any image updates from the previous frame. This is an opportunity for the driver to re-encode the desktop image again to increase the visual quality. Once there are no more updates, the OS presents the same frame as many times as indicated by the IDDCX_ADAPTER_CAPS value StaticDesktopReencodeFrameCount, then stops presenting until the next update.

MoveRegionCount

Starting in IddCx v1.7, the IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS flag was deprecated and move regions are no longer provided at acquire frame time, so this field will always be zero.

Number of move regions in this frame. Call IddCxSwapChainGetMoveRegions to get the move regions.

HwProtectedSurface

Indicates whether the provided surface is hardware protected.

PresentDisplayQPCTime

System QPC time of when this surface should be displayed on the indirect display monitor.

pSurface

Pointer to a IDXGIResource DX surface that contains the image to encode and transmit. The driver can use this DX surface anytime until IddCxSwapChainReleaseAndAcquire is called again.

Note

This surface is always a A8R8G8B8 formatted surface.

Remarks

A single empty dirty rect indicates there were no desktop updates.

Requirements

Requirement Value
Minimum supported client Windows 10
Header iddcx.h

See also

IDDCX_FRAME_STATISTICS