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

Статья
05/18/2024

Структура 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 драйвера мини-порта дисплея для выдачи запросов bit-block transfer (bitblt) для передачи данных из обратного буфера приложения в промежуточную поверхность. Затем промежуточная поверхность блокируется и считывается ЦП.

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

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