DXGKDDI_CANCELCOMMAND fungsi panggilan balik (d3dkmddi.h)

  • Artikel

Membersihkan sumber daya internal yang terkait dengan paket akses memori langsung (DMA) yang berada dalam antrean perangkat lunak penjadwal GPU tetapi tidak pernah mencapai antrean perangkat keras karena perangkat masuk ke status kesalahan. Status kesalahan seperti itu biasanya disebabkan oleh peristiwa Deteksi dan Pemulihan Waktu Habis (TDR ).

Sintaks

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

NTSTATUS DxgkddiCancelcommand(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_CANCELCOMMAND pCancelCommand
)
{...}

Parameter

hAdapter

Handel ke blok konteks yang terkait dengan adaptor tampilan. Driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis DirectX dalam parameter output MiniportDeviceContext dari fungsi DxgkDdiAddDevice .

pCancelCommand

Penunjuk ke struktur DXGKARG_CANCELCOMMAND yang menentukan sumber daya yang akan dibersihkan setelah perintah dihapus dari antrean perangkat keras.

Menampilkan nilai

Mengembalikan STATUS_SUCCESS setelah berhasil diselesaikan. Jika driver mengembalikan kode kesalahan, sistem operasi menyebabkan terjadinya bugcheck sistem. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Keterangan

Catatan Subsistem kernel grafis DirectX memanggil fungsi ini hanya jika DXGK_VIDSCHCAPS. Anggota CancelCommandAware diatur.
 
Jika driver mengembalikan kode kesalahan, subsistem kernel grafis DirectX menyebabkan terjadinya bugcheck sistem. Dalam file crash dump, kesalahan dicatat oleh pesan BugCheck 0x119, yang memiliki empat parameter berikut.
  1. 0x9
  2. Kode kesalahan NTSTATUS yang dikembalikan dari panggilan driver yang gagal
  3. Penunjuk ke struktur DXGKARG_CANCELCOMMAND
  4. Penunjuk ke struktur data penjadwal internal

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8
Server minimum yang didukung Windows Server 2012
Target Platform Desktop
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

Lihat juga

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice