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

Статья
02/06/2025

Структура 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 для создания описания блокируемой теневой поверхности. Подсистема графического ядра DirectX использует описание в вызове драйвера минипорта для отображения dxgkDdiCreateAllocation для создания блокируемой теневой поверхности.

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

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