Freigeben über


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

Siehe auch

DXGKARGCB_SAVEMEMORYFORHOTUPDATE

DXGKRNL_INTERFACE