DXGKCB_ALLOCATEPAGESFORMDL Rückruffunktion (d3dkmddi.h)

Artikel
02/26/2024

DXGKCB_ALLOCATEPAGESFORMDL ordnet physische Speicherseiten für eine Speicherdeskriptorliste (Memory Descriptor List, MDL) zu, die dem logischen Adressraum der IOMMU zugeordnet werden soll.

Syntax

DXGKCB_ALLOCATEPAGESFORMDL DxgkcbAllocatepagesformdl;

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

Parameter

[in] hAdapter

Ein Handle für die Grafikkarte.

[in/out] pAllocatePagesForMdl

Zeiger auf eine DXGKARGCB_ALLOCATEPAGESFORMDL-Struktur , die Argumente zum Zuordnen von Seiten für MDL enthält.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Hinweise

Diese Rückruffunktion ist eine Windows-Grafikporttreiberfunktion, die der MmAllocatePagesForMdl-Funktion entspricht.

DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, legen Sie die entsprechenden Member von DXGKARGCB_ALLOCATEPAGESFORMDL fest, und rufen Sie dann DxgkCbAllocatePagesForMdl über die DXGKRNL_INTERFACE auf.

Der gesamte Arbeitsspeicher, auf den die GPU während Pagingvorgängen zugreift oder über gpuMmu zugeordnet wird, muss der IOMMU zugeordnet werden. Dxgkrnl bietet Rückrufe für den Kernelmodustreiber, um die Zuordnung und Neuzuordnung in einem Schritt zu ermöglichen.

Hinweis

Aufrufe von DXGKCB_ALLOCATEPAGESFORMDL sind auf die MDL-Einschränkung von 4 GB PAGE_SIZE beschränkt, und Dxgkrnl gibt immer das flag MM_ALLOCATE_FULLY_REQUIRED im internen Aufruf der MmAllocatePagesForMdlEx-Funktion an. Der Treiber sollte auch keinen Arbeitsspeicher sperren. Dxgkrnl verwaltet gesperrte Seiten für den Treiber. Sobald der Speicher neu zugeordnet ist, stimmt die logische Adresse der für den Treiber bereitgestellten Seiten möglicherweise nicht mehr mit den physischen Adressen überein.

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