функция обратного вызова PFND3D10DDI_CREATESAMPLER (d3d10umddi.h)
Функция CreateSampler создает образец.
Синтаксис
PFND3D10DDI_CREATESAMPLER Pfnd3d10ddiCreatesampler;
void Pfnd3d10ddiCreatesampler(
D3D10DDI_HDEVICE unnamedParam1,
const D3D10_DDI_SAMPLER_DESC *unnamedParam2,
D3D10DDI_HSAMPLER unnamedParam3,
D3D10DDI_HRTSAMPLER unnamedParam4
)
{...}
Параметры
unnamedParam1
hDevice [in]
Дескриптор устройства отображения (графический контекст).
unnamedParam2
pSamplerDesc [in]
Указатель на структуру D3D10_DDI_SAMPLER_DESC, описывающую параметры, используемые драйвером отображения пользовательского режима для создания примера.
unnamedParam3
hSampler [in]
Дескриптор частных данных драйвера для примера. Драйвер возвращает размер в байтах области памяти, которую среда выполнения Microsoft Direct3D должна выделить для частных данных из вызова функции CalcPrivateSamplerSamplerS ize. Дескриптор действительно является указателем на область памяти, размер которой запрашивается драйвером. Драйвер использует этот регион памяти для хранения внутренних структур данных, связанных с его объектом sampler.
unnamedParam4
hRTSampler [in]
Дескриптор, который драйвер должен использовать в любое время, когда он вызывается в среду выполнения Direct3D.
Возвращаемое значение
Никакой
Замечания
Драйвер может использовать функцию обратного вызова pfnSetErrorCb для задания кода ошибки.
Драйвер может передать E_OUTOFMEMORY (если драйвер не хватает памяти) или D3DDDIERR_DEVICEREMOVED (если устройство было удалено) в вызове функции pfnSetErrorCb. Среда выполнения Direct3D определяет, что любые другие ошибки критически важны. Если драйвер передает какие-либо ошибки, включая D3DDDIERR_DEVICEREMOVED, среда выполнения Direct3D определит, что дескриптор недопустим; Поэтому среда выполнения не вызовет функцию DestroySampler, чтобы уничтожить дескриптор, который указывает параметр hSampler.
Драйвер отображения в пользовательском режиме не требуется для создания более 4096 уникальных экземпляров объектов sampler на устройстве одновременно.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| целевая платформа | Настольный |
| заголовка | d3d10umddi.h (include D3d10umddi.h) |