структура D3DKMT_RENDERFLAGS (d3dkmthk.h)

Статья
10/07/2023

Структура D3DKMT_RENDERFLAGS определяет тип буфера команд, который будет отображаться при вызове функции D3DKMTRender .

Синтаксис

typedef struct _D3DKMT_RENDERFLAGS {
  UINT ResizeCommandBuffer : 1;
  UINT ResizeAllocationList : 1;
  UINT ResizePatchLocationList : 1;
  UINT NullRendering : 1;
  UINT PresentRedirected : 1;
  UINT RenderKm : 1;
  UINT RenderKmReadback : 1;
  UINT Reserved : 25;
} D3DKMT_RENDERFLAGS;

Члены

ResizeCommandBuffer

Значение UINT, указывающее, следует ли изменять размер буфера команд. Драйвер помещает запрошенный размер в элемент NewCommandBufferSizeструктуры D3DKMT_RENDER . Так как запрос на изменение размера от драйвера может оказаться невозможным, драйвер всегда должен проверять возвращаемое значение размера.

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

ResizeAllocationList

Значение UINT, указывающее, следует ли изменять размер списка выделения. Драйвер помещает запрошенное количество элементов в элемент NewAllocationListSizeструктуры D3DKMT_RENDER . Так как запрос на изменение размера от драйвера может оказаться невозможным, драйвер всегда должен проверять возвращаемое значение размера.

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

ResizePatchLocationList

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

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

NullRendering

Значение UINT, указывающее, должен ли графический процессор обрабатывать какие-либо команды для контекста отрисовки. Флаг битового поля NullRendering установлен для информирования GPU не обрабатывать команды для контекста отрисовки. Флаг битового поля NullRendering устанавливается только во время исследования производительности и отладки для имитации бесконечно быстрой отрисовки подсистемы, которая по-прежнему должна выполнять накладные расходы при отправке буфера DMA и сигнализации. NullRendering никогда не задается во время типичных операций.

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

PresentRedirected

Значение UINT, указывающее, следует ли перенаправлять указанную команду. Команда содержит завершение одного кадра, даже если команда была выполнена в OpenGl ICD.

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

RenderKm

Поддерживается в Windows 7 и более поздних версиях.

Значение UINT, указывающее, предоставляет ли OpenGL ICD указатель на буфер команд для отрисовки в вызове ICD функции D3DKMTRender . Если этот флаг установлен, среда выполнения не вызывает функцию DxgkDdiRender драйвера дисплея miniport. Если этот флаг установлен, среда выполнения вызывает функцию DxgkDdiRenderKm драйвера дисплея miniport.

Задание этого элемента эквивалентно установке шестого бита 32-разрядного значения (0x00000020).

RenderKmReadback

Reserved

Этот элемент зарезервирован и должен иметь нулевое значение. Установка этого элемента эквивалентна установке оставшихся 26 бит (0xFFFFFFC0) 32-разрядного значения нулями.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Верхняя часть	d3dkmthk.h (включая D3dkmthk.h)

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

D3DKMT_RENDER