DXGKCB_SAVEMEMORYFORHOTUPDATE fonction de rappel (d3dkmddi.h)

  • Article

Un pilote miniport d’affichage en mode noyau peut appeler DXGKCB_SAVEMEMORYFORHOTUPDATE pour enregistrer la mémoire de l’adaptateur afin de prendre en charge la mise à jour à chaud du pilote.

Syntaxe

DXGKCB_SAVEMEMORYFORHOTUPDATE DxgkcbSavememoryforhotupdate;

NTSTATUS DxgkcbSavememoryforhotupdate(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARGCB_SAVEMEMORYFORHOTUPDATE pArgs
)
{...}

Paramètres

[in] hAdapter

Handle de l’adaptateur DXGK passé à DxgkDdiStartDevice.

[in] pArgs

Pointeur vers la structure DXGKARGCB_SAVEMEMORYFORHOTUPDATE qui contient des arguments pour ce rappel.

Valeur retournée

DXGKCB_SAVEMEMORYFORHOTUPDATE retourne STATUS_SUCCESS si l’opération réussit ; sinon, il retourne un code d’erreur à partir de Ntstatus.h.

Remarques

Chaque appel à DXGKCB_SAVEMEMORYFORHOTUPDATE enregistre un bloc de pages de mémoire physique, ainsi que éventuellement des métadonnées que le pilote souhaite associer au bloc de mémoire. Lorsque les pages sont restaurées, le pilote obtient un appel distinct pour chaque bloc de mémoire enregistré avec des métadonnées.

Pour plus de commodité, le rappel fournit 3 options pour enregistrer la mémoire physique :

  • En tant que tableau de plages de mémoire physique contiguës (pDataMemoryRanges)
  • En tant que MDL (pDataMdl)
  • En tant que mémoire tampon virtuelle (pData)

Un (et un seul) pointeur vers des données (pDataMemoryRanges, pDataMdl ou pData) ne doit pas avoir la valeur NULL.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1903 (WDDM 2.6)
En-tête d3dkmddi.h
IRQL PASSIVE_LEVEL

Voir aussi

DXGKARGCB_SAVEMEMORYFORHOTUPDATE

DXGKRNL_INTERFACE