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

  • Статья

Драйвер минипорта в режиме ядра вызывает DXGKCB_MAPMDLTOIOMMU для сопоставления списка дескрипторов памяти (MDL) с IOMMU, чтобы gpu смог получить доступ к базовой памяти.

Синтаксис

DXGKCB_MAPMDLTOIOMMU DxgkcbMapmdltoiommu;

NTSTATUS DxgkcbMapmdltoiommu(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_MAPMDLTOIOMMU pMapMdlToIoMmu
)
{...}

Параметры

[in] hAdapter

Дескриптор видеоадаптера. Драйвер предоставляет этот дескриптор для master/потенциального устройства в цепочке LDA.

[in/out] pMapMdlToIoMmu

Указатель на DXGKARGCB_MAPMDLTOIOMMU структуру, содержащую дескриптор памяти.

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

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

Комментарии

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

Если драйвер использует этот обратный вызов, он отвечает за то, чтобы время существования MDL превысило соответствующий DXGKCB_UNMAPMDLFROMIOMMU вызов. В противном случае вызов DXGKCB_UNMAPMDLFROMIOMMU имеет неопределенное поведение и может привести к нарушению безопасности страниц из MDL. Страницы могут быть перепрофилированы на мм к моменту их отмены сопоставления.

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

Требования

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

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

DXGKARGCB_MAPMDLTOIOMMU

DXGKCB_UNMAPMDLFROMIOMMU

DXGKRNL_INTERFACE