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

Функция 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 возвращает одно из следующих значений:

Замечания

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

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

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

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

Требования

См. также

DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA

DxgkDdiAddDevice

DxgkDdiCreateAllocation