DXGKDDI_DESTROYMEMORYBASIS fungsi panggilan balik (d3dkmddi.h)
Fungsi DxgkDdiDestroyMemoryBasis KMD menghancurkan basis memori yang dibuat oleh panggilan sebelumnya ke DxgkDdiCreateMemoryBasis.
Sintaks
DXGKDDI_DESTROYMEMORYBASIS DxgkddiDestroymemorybasis;
NTSTATUS DxgkddiDestroymemorybasis(
IN_CONST_HANDLE hAdapter,
IN_CONST_HANDLE hMemoryBasis
)
{...}
Parameter
hAdapter
[in] Handel ke blok konteks yang terkait dengan adaptor tampilan. KMD sebelumnya menyediakan handel ini ke Dxgkrnl dalam parameter output MiniportDeviceContext dari fungsi DxgiDdiAddDevice .
hMemoryBasis
Tangani dasar memori untuk menghancurkan. Handel ini sebelumnya dibuat oleh panggilan ke DxgkDdiCreateMemoryBasis.
Nilai kembali
DxgkDdiDestroyMemoryBasis mengembalikan STATUS_SUCCESS jika basis memori berhasil dihancurkan. Jika tidak, kode kesalahan NTSTATUS akan dikembalikan. Lihat Keterangan.
Keterangan
Dxgkrnl menafsirkan NTSTATUS yang dikembalikan yang tidak STATUS_SUCCESS sebagai pengembalian pemberitahuan kesalahan bencana. Seharusnya tidak ada jalur yang berfungsi dengan benar untuk mengembalikan apa pun kecuali keberhasilan dari fungsi ini, karena harus menjadi invarian yang diasumsikan bahwa handel yang disediakan adalah salah satu yang dibuat dan belum dihancurkan. Jika KMD mendeteksi input yang buruk, kode kesalahan yang dikembalikan memungkinkan Dxgkrnl menetapkan kegagalan invarian ke kernel OS alih-alih crash driver.
Untuk informasi selengkapnya, lihat Pelacakan bit kotor.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 11, versi 24H2 (WDDM 3.2) |
Header | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |