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

Weitere Informationen

DXGKARGCB_SAVEMEMORYFORHOTUPDATE

DXGKRNL_INTERFACE