структура D3DDDIARG_COPYFLAGS (d3dumddi.h)

  • Статья

Описывает обработку существующего содержимого ресурса во время операции копирования или обновления региона в этом ресурсе. Используется драйверами windows Display Driver Model (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

Этот элемент зарезервирован и должен иметь нулевое значение.

Присвоение этому элементу нулевого значения эквивалентно присвоению нулю битов от 3 до 24 (0x00FFFFFC) 32-разрядного элемента Value .

BoxValid

Указывает, что конечная область подресурса, в который необходимо скопировать, является допустимой. Если этот параметр не задан, необходимо обновить весь подресурс.

Задание этого элемента эквивалентно установке двадцать пятого бита 32-разрядного элемента Value (0x01000000).

Reserved2

Этот элемент зарезервирован и должен иметь нулевое значение.

Присвоение этому элементу нулевого значения эквивалентно присвоению нулю битов от 26 до 32 (0xFE000000) 32-разрядного элемента Value .

Value

Член объединения, который D3DDDIARG_COPYFLAGS содержит, который может содержать 32-разрядное значение, определяющее, как обрабатывать существующее содержимое ресурса во время операции копирования или обновления.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1
Минимальная версия сервера Windows Server 2012 R2
Верхняя часть d3dumddi.h (включая D3d10umddi.h)

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

D3DDDIARG_UPDATESUBRESOURCEUP