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

Статья
02/06/2025

Структура D3DKMDT_GDISURFACEDATA описывает поверхности, используемые аппаратным ускорением GDI и диспетчером окон рабочих столов (DWM).

Синтаксис

typedef struct _D3DKMDT_GDISURFACEDATA {
  [in]  UINT                    Width;
  [in]  UINT                    Height;
  [in]  D3DDDIFORMAT            Format;
  [in]  D3DKMDT_GDISURFACETYPE  Type;
  [in]  D3DKMDT_GDISURFACEFLAGS Flags;
  [out] UINT                    Pitch;
} D3DKMDT_GDISURFACEDATA;

Члены

[in] Width

Ширина поверхности в пикселях.

[in] Height

Высота поверхности в пикселях.

[in] Format

Значение D3DDDIFORMATтипа, указывающее формат пикселя поверхности. Поддерживаются следующие форматы:

D3DDDIFMT_A8B8G8R8

D3DDDIFMT_X8B8G8R8

D3DDDIFMT_A8R8G8B8

D3DDDIFMT_X8R8G8B8

D3DDDIFMT_A8

Формат D3DDDIFMT_A8 используется только для D3DKMDT_GDISURFACE_STAGING и D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE промежуточных типов поверхностей из перечисления D3DKMDT_GDISURFACETYPE.

[in] Type

Значение типа D3DKMDT_GDISURFACETYPE, указывающее тип поверхности.

[in] Flags

Зарезервировано для дальнейшего использования. Должно быть равно нулю.

[out] Pitch

Ширина поверхности, которая включает заполнение в байтах. Драйвер мини-порта отображения должен возвращать значение шага для всех выделений типа D3DKMDT_GDISURFACETYPE D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE, D3DKMDT_GDISURFACE_EXISTINGSYSMEM и D3DKMDT_GDISURFACE_TEXTURE_CROSSADAPTER.

Замечания

Структура D3DKMDT_GDISURFACEDATA передается подсистемой ядра графики Microsoft DirectX в вызове функции драйвера минипорта DxgkDdiGetStandardAllocationDriverData. Этот вызов создает описание поверхности, которую можно использовать для перенаправления аппаратным ускорением GDI и DWM.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается начиная с Windows 7.
заголовка	d3dkmdt.h

См. также

D3DDDIFORMAT

D3DKMDT_GDISURFACETYPE

DxgkDdiGetStandardAllocationDriverData

DxgkDdiPresent

Поделиться через