Bagikan melalui


DXGKDDI_RESETHWENGINE fungsi panggilan balik (d3dkmddi.h)

Dxgkrnl memanggil fungsi DxgkDdiResetHwEngine driver miniport tampilan (KMD) saat diperlukan reset mesin GPU.

Sintaks

DXGKDDI_RESETHWENGINE DxgkddiResethwengine;

NTSTATUS DxgkddiResethwengine(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_RESETHWENGINE pResetHwEngine
)
{...}

Parameter

hAdapter

[in] Handel ke blok konteks yang terkait dengan adaptor tampilan. KMD sebelumnya menyediakan handel ini ke Dxgkrnl di parameter output MiniportDeviceContext dari fungsi DxgkDdiAddDevice .

pResetHwEngine

[masuk/keluar] Arahkan ke struktur DXGKARG_RESETHWENGINE yang berisi informasi untuk mengatur ulang mesin perangkat keras.

Menampilkan nilai

DxgkDdiResetHwEngine mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, itu harus mengembalikan kode kesalahan NTSTATUS yang sesuai.

Keterangan

Implementasi DxgkDdiResetHwEngine harus memanggil panggilan balik DxgkCbInvalidateHwContext untuk menginformasikan OS dari semua konteks yang berjalan yang terpengaruh oleh operasi reset mesin GPU. OS akan membatalkan perangkat konteks ini (mengaturnya dalam kesalahan) dan tidak akan melakukan pengiriman di masa mendatang.

Mesin belum dianggap dilanjutkan setelah DxgkDdiResetHwEngine dipanggil, sehingga konteks yang tidak dibatalkan tidak diizinkan untuk dikirimkan. OS perlu mengaktifkan kembali interupsi dari mesin ini dan menyinkronkan statusnya dengan mesin GPU reset. Setelah itu, OS akan mengaktifkan interupsi dan memanggil DxgkDdiResumeHwEngine, yang menginstruksikan mesin GPU untuk mulai menjadwalkan semua konteks yang dapat dijalankan yang tidak terpengaruh oleh reset mesin.

Daftarkan implementasi Anda dari fungsi panggilan balik ini dalam struktur **DRIVER_INITIALIZATION_DATA ** .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1703 (WDDM 2.2)
Header d3dkmddi.h

Lihat juga

DXGKARG_RESETHWENGINE

DxgkDdiResumeHwEngine