DXGKCB_SAVEMEMORYFORHOTUPDATE fonction de rappel (d3dkmddi.h)
Un pilote miniport en mode noyau peut appeler DXGKCB_SAVEMEMORYFORHOTUPDATE pour enregistrer la mémoire de l’adaptateur pour 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 transmis à DxgkDdiStartDevice.
[in] pArgs
Pointeur vers la structure DXGKARGCB_SAVEMEMORYFORHOTUPDATE qui contient des arguments pour ce rappel.
Valeur de retour
DXGKCB_SAVEMEMORYFORHOTUPDATE retourne STATUS_SUCCESS si l’opération réussit ; sinon, elle retourne un code d’erreur de Ntstatus.h.
Remarques
Chaque appel à DXGKCB_SAVEMEMORYFORHOTUPDATE enregistre un bloc de pages de mémoire physique, ainsi que des métadonnées facultatives 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 les métadonnées.
Pour plus de commodité, le rappel fournit 3 options pour enregistrer la mémoire physique :
- Tableau de plages de mémoire physique contiguës (pDataMemoryRanges)
- En tant que MDL (pDataMdl)
- En tant que mémoire tampon de mémoire virtuelle (pData)
Une (et une seule) des pointeurs 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 1903 (WDDM 2.6) |
| d’en-tête | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |