DXGKCB_SAVEMEMORYFORHOTUPDATE Rückruffunktion (d3dkmddi.h)
Ein Kernelmodus-Miniporttreiber kann DXGKCB_SAVEMEMORYFORHOTUPDATE aufrufen, um Adapterspeicher zu speichern, um das Hot Update des Treibers 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 aus Ntstatus.hzurückgegeben.
Bemerkungen
Jeder Aufruf von DXGKCB_SAVEMEMORYFORHOTUPDATE speichert einen Block von physischen 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.
Aus Gründen der Einfachheit bietet der Rückruf drei Optionen zum Speichern des physischen Speichers:
- Als Array zusammenhängender physischer Speicherbereiche (pDataMemoryRanges)
- Als MDL (pDataMdl)
- Als virtueller Speicherpuffer (pData-)
Eine (und nur eine) der Zeiger auf Daten (pDataMemoryRanges, pDataMdl- oder pData-) darf nicht NULL sein.
DXGKCB_XXX Funktionen werden von Dxgkrnlimplementiert. Um diese Rückruffunktion zu verwenden, legen Sie die entsprechenden Member von DXGKARGCB_SAVEMEMORYFORHOTUPDATE fest, und rufen Sie dann DxgkCbSaveMemoryForHotUpdate über die DXGKRNL_INTERFACEauf.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 10, Version 1903 (WDDM 2.6) |
Header- | d3dkmddi.h |
IRQL- | PASSIVE_LEVEL |