DXGKCB_MAPMDLTOIOMMU Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Ein Kernelmodus-Miniporttreiber ruft DXGKCB_MAPMDLTOIOMMU auf, um eine Speicherdeskriptorliste (MDL) der IOMMU zuzuordnen, sodass der zugrunde liegende Speicher von der GPU aufgerufen werden 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 einen Anzeigeadapter. Der Treiber stellt dieses Handle für das Master-/Leadgerät in der LDA-Kette bereit.

[in/out] pMapMdlToIoMmu

Zeigen Sie auf eine DXGKARGCB_MAPMDLTOIOMMU Struktur, die ein Handle für den Arbeitsspeicher enthält.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Geben Sie andernfalls einen entsprechenden NTSTATUS-Wertefehlercode zurück.

Bemerkungen

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

Wenn der Treiber diesen Rückruf verwendet, ist er dafür verantwortlich, sicherzustellen, dass die Lebensdauer der MDL den entsprechenden DXGKCB_UNMAPMDLFROMIOMMU Aufruf überschreitet. Andernfalls weist der aufruf DXGKCB_UNMAPMDLFROMIOMMU nicht definiertes Verhalten auf und kann zu kompromittierter Sicherheit der Seiten aus der MDL führen. Die Seiten können von Mm nach dem Zeitpunkt, zu dem sie nicht zugeordnet sind, wiederverwendet werden.

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