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

Статья
02/26/2024

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

Синтаксис

PFND3D10DDI_CLEARDEPTHSTENCILVIEW Pfnd3d10ddiCleardepthstencilview;

void Pfnd3d10ddiCleardepthstencilview(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HDEPTHSTENCILVIEW unnamedParam2,
  UINT unnamedParam3,
  FLOAT unnamedParam4,
  UINT8 unnamedParam5
)
{...}

Параметры

unnamedParam1

hDevice [in]

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

unnamedParam2

hDepthStencilView [in]

Дескриптор для очистки представления трафарета глубины.

unnamedParam3

Набор элементов [in]

8-битовое целочисленное значение без знака, которое необходимо задать для набора элементов.

unnamedParam4

Глубина [в]

Вектор с плавающей точкой с одной точностью для установки глубины.

unnamedParam5

Флаги [in]

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

Значение	Значение
D3D10_DDI_CLEAR_DEPTH (0x01L)	Значение глубины (Z) фиксируется в диапазоне ZNear и ZFar окна просмотра, которое в настоящее время привязано к нулю слота с помощью Microsoft Direct3D. После этого Z снова зажимается в представляемом диапазоне текущего представления элементов глубины с помощью Direct3D.
D3D10_DDI_CLEAR_STENCIL (0x02L)	Значение набора элементов очищается.

Значение

D3D10_DDI_CLEAR_DEPTH (0x01L)

Значение глубины (Z) фиксируется в диапазоне ZNear и ZFar окна просмотра, которое в настоящее время привязано к нулю слота с помощью Microsoft Direct3D. После этого Z снова зажимается в представляемом диапазоне текущего представления элементов глубины с помощью Direct3D.

D3D10_DDI_CLEAR_STENCIL (0x02L)

Значение набора элементов очищается.

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

None

Remarks

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

Правила с плавающей запятой применяются к функции ClearDepthStencilView .

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

Требования

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

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

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb