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

Статья
02/06/2025

Структура D3DDDIARG_CLEAR описывает параметры аппаратной операции очистки.

Синтаксис

typedef struct _D3DDDIARG_CLEAR {
  [in] UINT  Flags;
  [in] UINT  FillColor;
  [in] FLOAT FillDepth;
  [in] UINT  FillStencil;
} D3DDDIARG_CLEAR;

Члены

[in] Flags

Значение UINT, указывающее, какие буферы необходимо очистить драйвер и как следует выполнять очистку операции. Этот элемент может быть битовой или из следующих значений. Дополнительные сведения см. в разделе "Примечания" на странице справки по Clear.

значение	значение
D3DCLEAR_TARGET (0x000000001l)	Драйвер должен очистить целевой объект отрисовки контекста к цвету, указанному элементом FillColor. Это значение определяется в D3d8types.h.
D3DCLEAR_STENCIL (0x000000004l)	Драйвер должен очистить буфер набора элементов контекста к значению, указанному элементом FillStencil. Это значение определяется в D3d8types.h.
D3DCLEAR_ZBUFFER (0x000000002l)	Драйвер должен очистить буфер глубины контекста до глубины, указанной элементом FillDepth. Это значение определяется в D3d8types.h.
D3DCLEAR_COMPUTERECTS (0x000000008l)	Если прямоугольники указаны для очистки, драйвер должен закрепить их к текущему порту просмотра. Если прямоугольники не указаны, драйвер должен очистить весь окно просмотра. Это значение определено в D3dhal.h.

[in] FillColor

Значение цвета, которое драйвер должен очистить целевой объект отрисовки контекста.

[in] FillDepth

Значение, которое драйвер должен использовать для задания глубины в буфере глубины контекста. Этот элемент может быть значением в диапазоне от 0.0 до 1.0.

[in] FillStencil

Значение, в которое драйвер должен очистить буфер набора элементов контекста. Этот элемент может быть целым числом в диапазоне от 0 до 2ⁿ-1, где n — это количество битов в буфере наборов элементов.

Замечания

При вызове функции драйвера отображения в пользовательском режиме Clear указатель на структуру D3DDDIARG_CLEAR передается в параметре pData. Среда выполнения Microsoft Direct3D передает сведения NumRect и параметры pRect в вызове функции драйвера отображения в пользовательском режиме Clear, чтобы указать прямоугольные области буфера, который драйвер должен очистить.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
заголовка	d3dumddi.h (include D3dumddi.h)

См. также

Clear

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