DXGKCB_OPENPHYSICALMEMORYOBJECT fonction de rappel (d3dkmddi.h)

Article
08/07/2023

Un pilote miniport d’affichage en mode noyau appelle DXGKCB_OPENPHYSICALMEMORYOBJECT pour ouvrir un objet de mémoire physique et l’associer à une carte.

Syntaxe

DXGKCB_OPENPHYSICALMEMORYOBJECT DxgkcbOpenphysicalmemoryobject;

NTSTATUS DxgkcbOpenphysicalmemoryobject(
  [in/out] IN_OUT_PDXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT pArgs
)
{...}

Paramètres

[in/out] pArgs

Pointeur vers une structure de DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT qui contient des informations sur l’objet de mémoire physique à ouvrir.

Valeur retournée

DXGKCB_OPENPHYSICALMEMORYOBJECT retourne STATUS_SUCCESS si l’opération réussit. Sinon, retourne un code d’erreur NTSTATUS approprié.

Remarques

Pour créer une liste de descripteurs d’adresses (ADL) à partir d’un objet de mémoire physique, elle doit d’abord être associée à une carte. Cela s’effectue normalement lorsque l’objet de mémoire physique est créé en spécifiant le paramètre hAdapter dans un appel à DXGKCB_CREATEPHYSICALMEMORYOBJECT. Toutefois, dans certains cas, le handle de l’adaptateur n’est pas disponible au moment où la mémoire a été allouée (par exemple, au début du processus de démarrage). Dans ce cas, le pilote doit appeler DXGKCB_OPENPHYSICALMEMORYOBJECT pour associer l’objet de mémoire physique à une carte avant d’appeler DXGKCB_ALLOCATEADL.

Pour plus d’informations, consultez La remappage iommu DMA .

DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, définissez les membres appropriés de DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT , puis appelez DxgkCbOpenPhysicalMemoryObject via le DXGKRNL_INTERFACE.