функция обратного вызова 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 должна выделить для частных данных из вызова функции драйвера CalcPrivateSamplerSize . Дескриптор — это просто указатель на область памяти, размер которой запрошен драйвером. Драйвер использует эту область памяти для хранения внутренних структур данных, связанных с объектом выборки.

unnamedParam4

hRTSampler [in]

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

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

None

Remarks

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

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

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

Требования

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

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

CalcPrivateSamplerSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_SAMPLER_DESC

DestroySampler

pfnSetErrorCb