DXGKCB_SAVEMEMORYFORHOTUPDATE fungsi panggilan balik (d3dkmddi.h)

  • Artikel

Driver miniport tampilan mode kernel dapat memanggil DXGKCB_SAVEMEMORYFORHOTUPDATE untuk menyimpan memori adaptor untuk mendukung pembaruan panas driver.

Sintaks

DXGKCB_SAVEMEMORYFORHOTUPDATE DxgkcbSavememoryforhotupdate;

NTSTATUS DxgkcbSavememoryforhotupdate(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARGCB_SAVEMEMORYFORHOTUPDATE pArgs
)
{...}

Parameter

[in] hAdapter

Handel ke adaptor DXGK yang diteruskan ke DxgkDdiStartDevice.

[in] pArgs

Penunjuk ke struktur DXGKARGCB_SAVEMEMORYFORHOTUPDATE yang berisi argumen untuk panggilan balik ini.

Menampilkan nilai

DXGKCB_SAVEMEMORYFORHOTUPDATE mengembalikan STATUS_SUCCESS jika operasi berhasil; jika tidak, kode kesalahan akan dikembalikan dari Ntstatus.h.

Keterangan

Setiap panggilan ke DXGKCB_SAVEMEMORYFORHOTUPDATE menyimpan blok halaman memori fisik, serta metadata opsional yang ingin dikaitkan dengan blok memori. Ketika halaman dipulihkan, driver akan mendapatkan panggilan terpisah untuk setiap blok memori yang disimpan bersama dengan metadata.

Untuk kenyamanan, panggilan balik menyediakan 3 opsi untuk menghemat memori fisik:

  • Sebagai array rentang memori fisik yang berdekatan (pDataMemoryRanges)
  • Sebagai MDL (pDataMdl)
  • Sebagai buffer memori virtual (pData)

Satu (dan hanya satu) pointer ke data (pDataMemoryRanges, pDataMdl atau pData) tidak boleh NULL.

DXGKCB_XXX diimplementasikan oleh Dxgkrnl. Untuk menggunakan fungsi panggilan balik ini, atur anggota DXGKARGCB_SAVEMEMORYFORHOTUPDATE yang sesuai lalu panggil DxgkCbSaveMemoryForHotUpdate melalui DXGKRNL_INTERFACE.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1903 (WDDM 2.6)
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

Lihat juga

DXGKARGCB_SAVEMEMORYFORHOTUPDATE

DXGKRNL_INTERFACE