DXGKCB_SAVEMEMORYFORHOTUPDATE Rückruffunktion (d3dkmddi.h)
Ein Display-Miniporttreiber im Kernelmodus kann DXGKCB_SAVEMEMORYFORHOTUPDATE aufrufen, um adapterspeichern zu können, um treiberinternes Update zu unterstützen.
Syntax
DXGKCB_SAVEMEMORYFORHOTUPDATE DxgkcbSavememoryforhotupdate;
NTSTATUS DxgkcbSavememoryforhotupdate(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARGCB_SAVEMEMORYFORHOTUPDATE pArgs
)
{...}
Parameter
[in] hAdapter
Ein Handle an den DXGK-Adapter, der an DxgkDdiStartDevice übergeben wird.
[in] pArgs
Ein Zeiger auf die DXGKARGCB_SAVEMEMORYFORHOTUPDATE-Struktur , die Argumente für diesen Rückruf enthält.
Rückgabewert
DXGKCB_SAVEMEMORYFORHOTUPDATE gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein Fehlercode von Ntstatus.h zurückgegeben.
Hinweise
Jeder Aufruf von DXGKCB_SAVEMEMORYFORHOTUPDATE speichert einen Block physischer Speicherseiten sowie optional Metadaten, die der Treiber dem Speicherblock zuordnen möchte. Wenn die Seiten wiederhergestellt werden, erhält der Treiber einen separaten Aufruf für jeden gespeicherten Speicherblock zusammen mit Metadaten.
Der Einfachheit halber bietet der Rückruf drei Optionen zum Speichern von physischem Arbeitsspeicher:
- Als Array zusammenhängender physischer Speicherbereiche (pDataMemoryRanges)
- Als MDL (pDataMdl)
- Als virtueller Speicherpuffer (pData)
Einer (und nur einer) der Zeiger auf Daten (pDataMemoryRanges, pDataMdl oder pData) darf nicht NULL sein.
DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, legen Sie die entsprechenden Member von DXGKARGCB_SAVEMEMORYFORHOTUPDATE fest, und rufen Sie dann DxgkCbSaveMemoryForHotUpdate über die DXGKRNL_INTERFACE auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1903 (WDDM 2.6) |
| Kopfzeile | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |