structure DXGKARG_RESTOREMEMORYFORHOTUPDATE (d3dkmddi.h)

Arguments utilisés pour restaurer la mémoire pour la mise à jour à chaud du pilote.

Syntaxe

typedef struct _DXGKARG_RESTOREMEMORYFORHOTUPDATE {
  [in] DXGK_RESTOREMEMORYFORHOTUPDATEFLAGS Flags;
  [in] PMDL                                pDataMdl;
  [in] UINT                                MetaDataSize;
  [in] PVOID                               pMetaData;
} DXGKARG_RESTOREMEMORYFORHOTUPDATE;

Membres

[in] Flags

Structure DXGK_RESTOREMEMORYFORHOTUPDATEFLAGS . Lorsque l’indicateur est défini, toutes les autres données d’entrée ont la valeur NULL. Le pilote peut supprimer toute la mémoire allouée pendant l’opération de restauration.

[in] pDataMdl

MDL (liste de descripteurs de mémoire), qui décrit les pages mémoire à restaurer.

Si le pilote retourne STATUS_SUCCESS à partir de cette fonction, il assume la propriété du MDL. Le pilote peut conserver le pointeur vers le MDL jusqu’à ce qu’il ne soit plus utilisé. Après cela, le pilote doit libérer les pages MDL et le MDL lui-même en appelant MmFreePagesFromMdl(pDataMdl) et ExFreePool(pDataMdl).

Le pilote peut utiliser MmMapLockedPagesSpecifyCache ou MmGetSystemAddressForMdlSafe pour obtenir un pointeur processeur vers la mémoire tampon.

Voici un exemple de la façon dont vous obtiendriez un pointeur processeur vers la mémoire tampon :

pBuffer = MmMapLockedPagesSpecifyCache(
    pMdl,
    KernelMode,
    MmCached,
    NULL,
    FALSE,
    NormalPagePriority | MdlMappingNoExecute);

pBuffer = MmGetSystemAddressForMdlSafe(pMdl, NormalPagePriority | MdlMappingNoExecute);

[in] MetaDataSize

Nombre d’octets dans la mémoire tampon vers laquelle pMetaData pointe.

[in] pMetaData

Pointeur de mémoire virtuelle vers les métadonnées associées au bloc de mémoire.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 version 1903
En-tête	d3dkmddi.h