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 位 Value 成员 (0x00000001) 的第一位。

Discard

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

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

Reserved1

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

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

BoxValid

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

设置此成员等效于设置 32 位 Value 成员 (0x01000000) 的第 25 位。

Reserved2

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

将此成员设置为零等效于将 32 位 Value 成员的位 26 到 32 (0xFE000000) 设置为零。

Value

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

要求

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

另请参阅

D3DDDIARG_UPDATESUBRESOURCEUP