функция обратного вызова PFND3D10DDI_CLEARRENDERTARGETVIEW (d3d10umddi.h)

Статья
02/06/2025

Функция ClearRenderTargetView очищает указанное представление целевого объекта отрисовки, задав его константным значением.

Синтаксис

PFND3D10DDI_CLEARRENDERTARGETVIEW Pfnd3d10ddiClearrendertargetview;

void Pfnd3d10ddiClearrendertargetview(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HRENDERTARGETVIEW unnamedParam2,
  FLOAT[4] unnamedParam3
)
{...}

Параметры

unnamedParam1

hDevice [in]

Дескриптор устройства отображения (графический контекст).

unnamedParam2

pColorRGBA [in]

Массив с плавающей запятой с четырьмя элементами с одной точностью, используемый драйвером для очистки представления целевого объекта отрисовки. Элемент массива 0 красный (R), 1 — зеленый (G), 2 — синий (B), а 3 — альфа-альфа (A).

unnamedParam3

hRenderTargetView [in]

Дескриптор для очистки представления целевого объекта отрисовки.

Возвращаемое значение

Никакой

Замечания

Драйвер может использовать функцию обратного вызова pfnSetErrorCb для задания кода ошибки.

Драйвер не должен столкнуться с ошибкой, за исключением D3DDDIERR_DEVICEREMOVED. Таким образом, если драйвер передает любую ошибку, за исключением D3DDDIERR_DEVICEREMOVED, при вызове функции pfnSetErrorCb среда выполнения Direct3D определит, что ошибка является критической. Даже если устройство было удалено, драйвер не требуется возвращать D3DDDIERR_DEVICEREMOVED; Однако если удаление устройства вмешалось в операцию ClearRenderTargetView (что обычно не должно произойти), драйвер может вернуть D3DDDIERR_DEVICEREMOVED.

Требования

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

См. также

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb

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