DXGKCB_SAVEMEMORYFORHOTUPDATE funzione di callback (d3dkmddi.h)
Un driver miniport in modalità kernel può chiamare DXGKCB_SAVEMEMORYFORHOTUPDATE per salvare la memoria dell'adattatore per supportare l'aggiornamento frequente del driver.
Sintassi
DXGKCB_SAVEMEMORYFORHOTUPDATE DxgkcbSavememoryforhotupdate;
NTSTATUS DxgkcbSavememoryforhotupdate(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARGCB_SAVEMEMORYFORHOTUPDATE pArgs
)
{...}
Parametri
[in] hAdapter
Handle per la scheda DXGK passata a DxgkDdiStartDevice.
[in] pArgs
Puntatore alla struttura DXGKARGCB_SAVEMEMORYFORHOTUPDATE che contiene argomenti per questo callback.
Valore restituito
DXGKCB_SAVEMEMORYFORHOTUPDATE restituisce STATUS_SUCCESS se l'operazione ha esito positivo; in caso contrario, restituisce un codice di errore da Ntstatus.h.
Commenti
Ogni chiamata a DXGKCB_SAVEMEMORYFORHOTUPDATE salva un blocco di pagine di memoria fisica e, facoltativamente, metadati che il driver desidera associare al blocco di memoria. Quando le pagine vengono ripristinate, il driver riceverà una chiamata separata per ogni blocco di memoria salvato insieme ai metadati.
Per praticità, il callback offre 3 opzioni per salvare la memoria fisica:
- Come matrice di intervalli di memoria fisica contigui (pDataMemoryRanges)
- Come MDL (pDataMdl)
- Come buffer di memoria virtuale (pData)
Uno (e solo uno) dei puntatori ai dati (pDataMemoryRanges, pDataMdl o pData) non deve essere NULL.
DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, impostare i membri appropriati di DXGKARGCB_SAVEMEMORYFORHOTUPDATE e quindi chiamare DxgkCbSaveMemoryForHotUpdate tramite il DXGKRNL_INTERFACE.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 versione 1903 (WDDM 2.6) |
| Intestazione | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |