D3DDDIARG_COPYFLAGS结构 (d3dumddi.h)

介绍如何在资源内某个区域的复制或更新作期间处理资源的现有内容。 由 Windows 显示驱动程序模型 (WDDM) 1.3 及更高版本的用户模式显示驱动程序使用。

语法

typedef struct D3DDDIARG_COPYFLAGS {
  union {
    struct {
      UINT NoOverwrite : 1;
      UINT Discard : 1;
      UINT Reserved1 : 22;
      UINT BoxValid : 1;
      UINT Reserved2 : 7;
    };
    UINT Value;
  };
} D3DDDIARG_COPYFLAGS;

成员

NoOverwrite

指定调用方保证任何以前的呈现作当前不会引用或访问使用新数据写入的图面部分。 驱动程序可以利用此功能来优化性能和内存使用情况。

设置此成员等效于设置 32 位 成员的第一位(0x00000001)。

Discard

指定用户模式显示驱动程序可以放弃整个资源以前的内容。 驱动程序可以利用此功能来优化性能和内存使用情况。

设置此成员等效于设置 32 位 成员的第二位(0x00000002)。

Reserved1

此成员是保留的,应设置为零。

将此成员设置为零相当于将 32 位 成员设置为零的 3 到 24 位(0x00FFFFFC)。

BoxValid

指定要复制到的子资源的目标区域有效。 如果未设置,则必须更新整个子资源。

设置此成员相当于设置 32 位 成员(0x01000000)的 25 位。

Reserved2

此成员是保留的,应设置为零。

将此成员设置为零相当于将 32 位 成员的 26 到 32(0xFE000000)位设置为零。

Value

联合中的成员,该成员 D3DDDIARG_COPYFLAGS 包含一个可以保存 32 位值,该值标识如何在复制或更新作期间处理资源的现有内容。

要求

要求 价值
最低支持的客户端 Windows 8.1
支持的最低服务器 Windows Server 2012 R2
标头 d3dumddi.h(包括 D3d10umddi.h)

另请参阅

D3DDDIARG_UPDATESUBRESOURCEUP