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

  • Статья

Функция CreateRasterizerState создает состояние растеризатора.

Синтаксис

PFND3D10DDI_CREATERASTERIZERSTATE Pfnd3d10ddiCreaterasterizerstate;

void Pfnd3d10ddiCreaterasterizerstate(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D10_DDI_RASTERIZER_DESC *unnamedParam2,
  D3D10DDI_HRASTERIZERSTATE unnamedParam3,
  D3D10DDI_HRTRASTERIZERSTATE unnamedParam4
)
{...}

Параметры

unnamedParam1

hDevice [in]

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

unnamedParam2

pRasterizerDesc [in]

Указатель на структуру D3D10_DDI_RASTERIZER_DESC , описывающую параметры, которые драйвер отображения пользовательского режима использует для создания состояния растеризатора.

unnamedParam3

hRasterizerState [in]

Дескриптор личных данных драйвера для состояния растеризатора. Драйвер возвращает размер (в байтах) области памяти, которую среда выполнения Microsoft Direct3D должна выделить для частных данных из вызова функции драйвера CalcPrivateRasterizerStateSize . Дескриптор — это просто указатель на область памяти, размер которой запрошен драйвером. Драйвер использует эту область памяти для хранения внутренних структур данных, связанных с объектом состояния растеризатора.

unnamedParam4

hRTRasterizerState [in]

Дескриптор состояния растеризатора, который драйвер должен использовать при каждом вызове обратно в среду выполнения Direct3D.

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

None

Remarks

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

Драйвер может передать E_OUTOFMEMORY (если у драйвера заканчивается память) или D3DDDIERR_DEVICEREMOVED (если устройство было удалено) в вызове функции pfnSetErrorCb . Среда выполнения Direct3D определит, что любые другие ошибки являются критическими. Если драйвер передает ошибки, в том числе D3DDDIERR_DEVICEREMOVED, среда выполнения Direct3D определит, что дескриптор недопустим; Поэтому среда выполнения не будет вызывать функцию DestroyRasterizerState для уничтожения дескриптора, указанного параметром hRasterizerState .

Драйвер отображения пользовательского режима не требуется для создания более 4096 уникальных экземпляров объектов состояния растеризатора на устройстве одновременно.

Требования

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

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

CalcPrivateRasterizerStateSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_RASTERIZER_DESC

DestroyRasterizerState

pfnSetErrorCb