DXGKCB_SAVEMEMORYFORHOTUPDATE fungsi panggilan balik (d3dkmddi.h)
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 |