функция обратного вызова DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA (d3dkmddi.h)

Статья
11/11/2024

Функция dxgkDdiGetStandardAllocationDriverData возвращает описание стандартного типа выделения.

Синтаксис

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

NTSTATUS DxgkddiGetstandardallocationdriverdata(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}

Параметры

[in] hAdapter

Дескриптор к блоку контекста, связанному с адаптером отображения. Драйвер отображения в режиме ядра (KMD) ранее предоставил этот дескриптор для Dxgkrnl в своей функции DxgkDdiAddDevice.

[in/out] pGetStandardAllocationDriverData

Указатель на структуруDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA, описывающую стандартное выделение.

Возвращаемое значение

DxgkDdiGetStandardAllocationDriverData возвращает одно из следующих значений:

Возвращаемый код	Описание
STATUS_SUCCESS	DxgkDdiGetStandardAllocationDriverData успешно вернул описание стандартного типа выделения.
STATUS_NO_MEMORY	DxgkDdiGetStandardAllocationDriverData не удалось выделить память, необходимую для завершения.

Замечания

стандартные типы выделения — это выделения, которые должны быть созданы в режиме ядра без взаимодействия с драйвером отображения в пользовательском режиме.

Dxgkrnl вызывает драйвер в режиме ядра (KMD) функцию DxgkDdiGetStandardAllocationDriverData для создания описания стандартного типа выделения, указанного параметром pGetStandardAllocationDriverData. KMD возвращает описание типа выделения в pAllocationPrivateDriverData и pResourcePrivateDriverData членов структуры DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA, на которую указывает параметр pGetStandardAllocationDriverData. Dxgkrnl впоследствии передает описание функции DxgkDdiCreateAllocation, чтобы создать выделение.

Начиная с Windows 7, если KMD обрабатывает вызов DxgkDdiGetStandardAllocationDriverData для создания выделений для аппаратного ускорения GDI, драйвер должен задать шаг выделения для видимых выделений ЦП, **pGetStandardAllocationDriverData->pCreateGdiSurfaceData->**шаг.

DxgkDdiGetStandardAllocationDriverData должен быть доступен для страницы.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	d3dkmddi.h
IRQL	PASSIVE_LEVEL

См. также

DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA

DxgkDdiAddDevice

DxgkDdiCreateAllocation

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