DXGKCB_SAVEMEMORYFORHOTUPDATE funzione di callback (d3dkmddi.h)

  • Articolo

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

Vedi anche

DXGKARGCB_SAVEMEMORYFORHOTUPDATE

DXGKRNL_INTERFACE