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

Статья
08/07/2023

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть	d3dkmdt.h (включая D3dkmddi.h)