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

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

Синтаксис

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

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

Параметры

[in] hAdapter

Дескриптор для блока контекста, связанного с видеоадаптером. Драйвер мини-порта дисплея ранее предоставлял этот дескриптор подсистеме ядра графики Microsoft DirectX в выходном параметре MiniportDeviceContext функции DxgkDdiAddDevice .

[in/out] pGetStandardAllocationDriverData

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

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

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

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

Комментарии

Стандартные типы выделения — это выделения, которые должны создаваться в режиме ядра без взаимодействия с драйвером отображения пользовательского режима. Подсистема графического ядра DirectX вызывает функцию DxgkDdiGetStandardAllocationDriverData для создания описания стандартного типа выделения, заданного параметром pGetStandardAllocationDriverData . Драйвер мини-порта отображения возвращает описание типа выделения в элементах pAllocationPrivateDriverData и pResourcePrivateDriverDataструктуры DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA , на которую указывает параметр pGetStandardAllocationDriverData . Впоследствии подсистема графического ядра DirectX передает описание функции DxgkDdiCreateAllocation , чтобы фактически создать выделение.

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

DxgkDdiGetStandardAllocationDriverData следует сделать страничной.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Целевая платформа	Персональный компьютер
Верхняя часть	d3dkmddi.h
IRQL	PASSIVE_LEVEL

См. также раздел

DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA

DxgkDdiAddDevice

DxgkDdiCreateAllocation