Поделиться через

структура 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-разрядного значения значения (0x00000001).

Discard

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

Установка этого элемента эквивалентна настройке второго бита 32-разрядного элемента значения (0x00000002).

Reserved1

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

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

BoxValid

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

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

Reserved2

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

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

Value

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 8.1
минимальный поддерживаемый сервер Windows Server 2012 R2
заголовка d3dumddi.h (include D3d10umddi.h)

См. также

D3DDDIARG_UPDATESUBRESOURCEUP