DXGKCB_OPENPHYSICALMEMORYOBJECT fonction de rappel (d3dkmddi.h)

Un pilote miniport en mode noyau appelle DXGKCB_OPENPHYSICALMEMORYOBJECT pour ouvrir un objet mémoire physique et l’associer à un adaptateur.

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 DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT qui contient des informations sur l’objet mémoire physique à ouvrir.

Valeur de retour

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 mémoire physique, elle doit d’abord être associée à un adaptateur. Cela est normalement effectué lorsque l’objet 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 mémoire physique à un adaptateur avant d’appeler DXGKCB_ALLOCATEADL.

Pour plus d’informations, consultez de remapping 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.

Exigences

Voir aussi

DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT

DXGKCB_ALLOCATEADL

DXGKCB_CLOSEPHYSICALMEMORYOBJECT

DXGKCB_CREATEPHYSICALMEMORYOBJECT