DXGKCB_MAPMDLTOIOMMU Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Ein Display-Miniporttreiber im Kernelmodus ruft DXGKCB_MAPMDLTOIOMMU auf, um der IOMMU eine Speicherdeskriptorliste (Memory Descriptor List, MDL) zuzuordnen, damit die GPU auf den zugrunde liegenden Arbeitsspeicher zugreifen kann.

Syntax

DXGKCB_MAPMDLTOIOMMU DxgkcbMapmdltoiommu;

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

Parameter

[in] hAdapter

Ein Handle für eine Grafikkarte. Der Treiber stellt dieses Handle für das master/Lead-Gerät in der LDA-Kette bereit.

[in/out] pMapMdlToIoMmu

Zeiger auf eine DXGKARGCB_MAPMDLTOIOMMU Struktur, die ein Handle auf den Arbeitsspeicher enthält.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Geben Sie andernfalls einen geeigneten NTSTATUS-Werte-Fehlercode zurück.

Hinweise

DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, legen Sie das entsprechende Element von DXGKARGCB_MAPMDLTOIOMMU fest, und rufen Sie dann DxgkCbMapMdlToIoMmu über die DXGKRNL_INTERFACE auf.

Wenn der Treiber diesen Rückruf verwendet, ist er dafür verantwortlich, sicherzustellen, dass die Lebensdauer der MDL den entsprechenden DXGKCB_UNMAPMDLFROMIOMMU Aufrufs überschreitet. Andernfalls weist der DXGKCB_UNMAPMDLFROMIOMMU Aufruf ein undefiniertes Verhalten auf und kann zu einer Kompromittierung der Sicherheit der Seiten aus der MDL führen. Die Seiten können von Mm neu verwendet werden, wenn sie nicht zugeordnet sind.

Weitere Informationen finden Sie unter IOMMU-basierte GPU-Isolation .