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

Статья
08/07/2023

Выполняет операцию передачи битового блока (bitblt) из исходной текстуры в конечную текстуру, включая все вложенные значения исходной текстуры. Реализовано с помощью драйверов отображения windows Display Driver Model (WDDM) 1.2 или более поздней версии в пользовательском режиме.

Синтаксис

PFND3DDDI_TEXBLT1 Pfnd3dddiTexblt1;

HRESULT Pfnd3dddiTexblt1(
  HANDLE hDevice,
  const D3DDDIARG_TEXBLT1 *unnamedParam2
)
{...}

Параметры

hDevice

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

unnamedParam2

pData [in]

Указатель на структуру D3DDDIARG_TEXBLT1 , которая определяет параметры для операции bitblt текстуры.

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

Возвращает S_OK или соответствующий результат ошибки, если операция bitblt текстуры не выполнена.

Среда выполнения Microsoft Direct3D вызывает функцию TexBlt драйвера отображения пользовательского режима, чтобы сообщить драйверу о выполнении операции bitblt из исходной текстуры в целевую текстуру. Текстура также может быть кубической картой среды. Драйвер должен скопировать прямоугольник, заданный элементом SrcRectструктуры D3DDDIARG_TEXBLT в исходной текстуре, в расположение, указанное элементом DstPoint D3DDDIARG_TEXBLT в конечной текстуре. Текстуры назначения и источника определяются дескрипторами hDstResource и hSrcResource D3DDDIARG_TEXBLT соответственно.

Для текстур, сопоставленных с MIP, драйвер также должен скопировать все вложенные значения MIP-карты, которые присутствуют в исходной текстуре. Исходные и целевые текстуры могут содержать разное количество уровней MIP-карты. В этом случае драйвер должен скопировать общие уровни. Например, если исходная текстура 256 x 256 имеет восемь уровней MIP-карты, а назначением является текстура 64x64 с шестью уровнями, драйвер должен скопировать шесть соответствующих уровней из источника. Обратите внимание, что размеры верхнего уровня MIP конечной текстуры всегда меньше или равны измерениям верхнего уровня MIP исходной текстуры.

Дескрипторы источника и назначения всегда ссылаются на поверхности верхнего уровня и никогда не ссылаются на подуровневые MIP-карты.

Чтобы скопировать произвольный уровень текстуры MIP-карты, среда выполнения вызывает функцию Blt драйвера.

Форматы пикселей исходных и целевых текстур идентичны, и, как правило, указанная операция bitblt безопасна для выполнения.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Персональный компьютер
Верхняя часть	d3dumddi.h (включая D3dumddi.h)

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

Blt

D3DDDIARG_TEXBLT1

D3DDDI_DEVICEFUNCS