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

Статья
02/06/2025

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

Синтаксис

typedef struct _D3DKMDT_STAGINGSURFACEDATA {
  [in]  UINT Width;
  [in]  UINT Height;
  [out] UINT Pitch;
} D3DKMDT_STAGINGSURFACEDATA;

Члены

[in] Width

Ширина промежуточного буфера в пикселях.

[in] Height

Высота промежуточного буфера в пикселях.

[out] Pitch

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

Замечания

Структура D3DKMDT_STAGINGSURFACEDATA передается подсистемой ядра графики Microsoft DirectX в вызове драйвера минипорта dxgkDdiGetStandardAllocationDriverData для создания описания блокируемой промежуточной поверхности. Графическая подсистема вызывает функцию драйвера минипорта для отображения dxgkDdiPresent для выдачи запросов на передачу данных из обратного буфера приложения в промежуточную поверхность. Затем промежуточная поверхность блокируется и считывается ЦП.

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

Эта промежуточная поверхность всегда создается в виде 8-битового формата пикселей RGB(который указывается значением D3DDDIFMT_X8R8G8B8 из перечисления D3DDDIFORMAT). Так как размеры промежуточной поверхности всегда соответствуют измерениям заднего буфера, для текущей операции с промежуточной поверхностью не требуется операция растяжения или сжатия.