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

  • Статья

Для данного ресурса с плитками возвращает количество упакованных mips и количество плиток, необходимых для хранения всех упакованных mips.

Синтаксис

PFND3DWDDM1_3DDI_GETMIPPACKING Pfnd3dwddm13DdiGetmippacking;

void Pfnd3dwddm13DdiGetmippacking(
  D3D10DDI_HDEVICE hDevice,
  D3D10DDI_HRESOURCE hTiledResource,
  UINT *pNumPackedMips,
  UINT *pNumTilesForPackedMips
)
{...}

Параметры

hDevice

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

hTiledResource

Дескриптор для ресурса с плиткой.

pNumPackedMips

Указатель на переменную, которая получает количество упакованных mips для заданного среза массива, включая все mips, которые не используют стандартные фигуры плитки.

Если упаковка отсутствует, должно быть возвращено нулевое значение.

pNumTilesForPackedMips

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

Этот параметр игнорируется, если *pNumPackedMips возвращает ноль.

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

None

Remarks

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

Упакованные mips включают случаи, когда несколько небольших mips совместно используют плитки, а также mips, для которых данное устройство не может использовать стандартные фигуры плиток. Можно считать весь ресурс упакованным.

Приложениям не сообщается, что фигуры или макеты плитки для упакованных mips и должны просто сопоставлять все или ни одну из упакованных плиток, если требуется доступ к какой-либо из MIP-карт. В противном случае наблюдаемое сопоставление отдельных пикселей, к которых осуществляется доступ, не определено и относится к независимому поставщику оборудования (IHV).

MIP-карты с размерами пикселей, которые полностью заполняют по крайней мере одну плитку стандартной формы во всех измерениях, не могут считаться частью набора упакованных mips. В противном случае среда выполнения удалит устройство в недопустимом драйвере.
Одним из примеров измерений, которые устройство может правильно вставить в упакованные плитки (то есть IHV может использовать собственную пользовательскую разбивку плитки), является MIP, который имеет по крайней мере одну плитку в ширину, но меньше, чем высокая плитка. В идеале, однако, устройство будет использовать стандартную разбивку плиток для этого случая (чтобы приложение пользовалось плитками стандартным способом). Если устройству требуется использовать пользовательскую плитку, приложение не сообщает, что такое разбивка плитки (только сколько плиток участвует в упаковке в целом), и, следовательно, теряет некоторую свободу.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1,WDDM 1.3
Минимальная версия сервера Windows Server 2012 R2
Целевая платформа Персональный компьютер
Верхняя часть d3d10umddi.h (включая D3d10umddi.h)

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

pfnSetErrorCb