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

Статья
02/26/2024

DXGKCB_ALLOCATEPAGESFORMDL выделяет страницы физической памяти для списка дескрипторов памяти (MDL) для сопоставления с логическим адресным пространством IOMMU.

Синтаксис

DXGKCB_ALLOCATEPAGESFORMDL DxgkcbAllocatepagesformdl;

NTSTATUS DxgkcbAllocatepagesformdl(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_ALLOCATEPAGESFORMDL pAllocatePagesForMdl
)
{...}

Параметры

[in] hAdapter

Дескриптор видеоадаптера.

[in/out] pAllocatePagesForMdl

Указатель на структуру DXGKARGCB_ALLOCATEPAGESFORMDL , содержащую аргументы для выделения страниц для MDL.

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

Возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае верните соответствующий код ошибки NTSTATUS.

DXGKCB_XXX функции реализуются dxgkrnl. Чтобы использовать эту функцию обратного вызова, задайте соответствующие члены DXGKARGCB_ALLOCATEPAGESFORMDL , а затем вызовите DxgkCbAllocatePagesForMdl через DXGKRNL_INTERFACE.

Вся память, доступная GPU во время операций подкачки или сопоставленная с помощью GpuMmu, должна быть сопоставлена с IOMMU. Dxgkrnl предоставляет обратные вызовы драйверу режима ядра, чтобы разрешить выделение и повторное сопоставление за один шаг.

Примечание

Вызовы DXGKCB_ALLOCATEPAGESFORMDL ограничены ограничением MDL PAGE_SIZE 4 ГБ, а Dxgkrnl всегда указывает флаг MM_ALLOCATE_FULLY_REQUIRED во внутреннем вызове функции MmAllocatePagesForMdlEx. Драйвер также не должен блокировать память. Dxgkrnl будет управлять заблокированными страницами для драйвера, и после переназначения памяти логический адрес страниц, предоставленный драйверу, может перестать соответствовать физическим адресам.

Дополнительные сведения см. в разделе Изоляция GPU на основе IOMMU .

Требования

Требование	Значение
Минимальная версия клиента	Windows 10, версия 1803 (WDDM 2.4)
Верхняя часть	d3dkmddi.h
IRQL	PASSIVE_LEVEL

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

DXGKARGCB_ALLOCATEPAGESFORMDL

DXGKCB_FREEPAGESFROMMDL

DXGKRNL_INTERFACE