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

  • Статья

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

Синтаксис

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

Члены

[in] Flags

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

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

[in] FillColor

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

[in] FillDepth

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

[in] FillStencil

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

Комментарии

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

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть d3dumddi.h (включая D3dumddi.h)

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

Очистить