функция обратного вызова 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.
Возвращаемое значение
Никакой
Замечания
Драйвер может использовать функцию обратного вызова pfnSetErrorCb для задания кода ошибки.
Драйвер может передать E_OUTOFMEMORY (если драйвер не хватает памяти) или D3DDDIERR_DEVICEREMOVED (если устройство было удалено) в вызове функции pfnSetErrorCb. Среда выполнения Direct3D определяет, что любые другие ошибки критически важны. Если драйвер передает какие-либо ошибки, включая D3DDDIERR_DEVICEREMOVED, среда выполнения Direct3D определит, что дескриптор недопустим; Поэтому среда выполнения не вызовет функцию DestroyRasterizerState, чтобы уничтожить дескриптор, который указывает параметр hRasterizerState.
Драйвер отображения в пользовательском режиме не требуется для создания более 4096 уникальных экземпляров объектов растризатора-состояния на устройстве одновременно.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| целевая платформа | Настольный |
| заголовка | d3d10umddi.h (include D3d10umddi.h) |