DXGKCB_MAPMDLTOIOMMU funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

Un driver miniport in modalità kernel chiama DXGKCB_MAPMDLTOIOMMU per eseguire il mapping di un elenco di descrittori di memoria (MDL) all'IOMMU in modo che la memoria sottostante possa essere accessibile dalla GPU.

Sintassi

DXGKCB_MAPMDLTOIOMMU DxgkcbMapmdltoiommu;

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

Parametri

[in] hAdapter

Handle per una scheda di visualizzazione. Il driver fornisce questo handle per il dispositivo master/lead nella catena LDA.

[in/out] pMapMdlToIoMmu

Puntatore a una struttura DXGKARGCB_MAPMDLTOIOMMU che contiene un handle per la memoria.

Valore restituito

Restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, restituisce un codice di errore NTSTATUS Values appropriato.

Commenti

DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, impostare il membro appropriato di DXGKARGCB_MAPMDLTOIOMMU e quindi chiamare DxgkCbMapMdlToIoMmu tramite il DXGKRNL_INTERFACE.

Se il driver usa questo callback, è responsabile di garantire che la durata del file MDL superi la chiamata DXGKCB_UNMAPMDLFROMIOMMU corrispondente. In caso contrario, la chiamata DXGKCB_UNMAPMDLFROMIOMMU ha un comportamento indefinito e può causare una compromissione della sicurezza delle pagine da MDL. Le pagine potrebbero essere riutilizzate da Mm al momento in cui non vengono mappate.

Per altre informazioni, vedere Isolamento GPU basato su IOMMU .