структура D3DKMDT_SHADOWSURFACEDATA (d3dkmdt.h)

Статья
02/23/2024

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

Синтаксис

typedef struct _D3DKMDT_SHADOWSURFACEDATA {
  [in]  UINT         Width;
  [in]  UINT         Height;
  [in]  D3DDDIFORMAT Format;
  [out] UINT         Pitch;
} D3DKMDT_SHADOWSURFACEDATA;

Члены

[in] Width

Ширина поверхности в пикселях. Драйвер возвращает значение ширины.

[in] Height

Высота поверхности в пикселях. Драйвер возвращает значение высоты.

[in] Format

D3DDDIFORMAT типизированное значение, указывающее формат пикселей поверхности. Драйвер возвращает значение формата.

[out] Pitch

Ширина поверхности в байтах. Драйвер должен вернуть значение тона, так как поверхность тени блокируется.

Структура D3DKMDT_SHADOWSURFACEDATA передается подсистемой ядра графики Microsoft DirectX в вызове функции DxgkDdiGetStandardAllocationDriverData драйвера дисплея miniport для создания описания запираемой поверхности тени. Подсистема ядра графики DirectX использует описание в вызове функции DxgkDdiCreateAllocation драйвера miniport дисплея для создания запираемой поверхности тени.

ЦП втягивается в заблокированную поверхность тени, разблокирует поверхность тени, а затем выполняет запросы на передачу битовых блоков (bitblt) с помощью функции DxgkDdiPresent с поверхности тени на соответствующую общую основную поверхность. Запросы на передачу битовых блоков также выдаются для передачи данных из общей основной поверхности в теневой.

Операция преобразования цвета, растяжения или сжатия не требуется при копировании данных из теневой поверхности или в нее, так как исходный и целевой форматы и размеры теней и общих первичных поверхностей всегда совпадают.