DXGKDDI_SYSTEM_DISPLAY_WRITE fungsi panggilan balik (dispmprt.h)

Artikel
08/07/2023

Dipanggil oleh sistem operasi untuk meminta driver miniport tampilan untuk menulis blok gambar ke perangkat tampilan.

Dimulai dengan Windows 8, sistem operasi memanggil fungsi ini selama operasi pemeriksaan bug setelah kesalahan penghentian sistem. Sistem operasi memanggil fungsi ini hanya jika perangkat tampilan sebelumnya direset melalui panggilan ke DxgkDdiSystemDisplayEnable.

Sintaks

DXGKDDI_SYSTEM_DISPLAY_WRITE DxgkddiSystemDisplayWrite;

void DxgkddiSystemDisplayWrite(
  [in] PVOID MiniportDeviceContext,
  [in] PVOID Source,
  [in] UINT SourceWidth,
  [in] UINT SourceHeight,
  [in] UINT SourceStride,
  [in] UINT PositionX,
  [in] UINT PositionY
)
{...}

Parameter

[in] MiniportDeviceContext

Handel ke blok konteks yang terkait dengan adaptor tampilan. Fungsi DxgkDdiAddDevice driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis Microsoft DirectX.

[in] Source

Penunjuk ke alamat awal gambar sumber yang akan ditulis ke layar bugcheck yang menampilkan informasi tentang kesalahan penghentian sistem.

[in] SourceWidth

Nilai UINT yang menentukan lebar, dalam satuan piksel, dari gambar sumber yang ditentukan.

[in] SourceHeight

Nilai UINT yang menentukan tinggi, dalam satuan piksel, dari gambar sumber yang ditentukan.

[in] SourceStride

Nilai UINT yang menentukan jumlah byte untuk setiap baris gambar sumber yang ditentukan.

[in] PositionX

Nilai UINT yang menentukan koordinat X awal yang harus ditulis gambar sumber yang ditentukan pada perangkat tampilan.

[in] PositionY

Nilai UINT yang menentukan koordinat Y awal yang harus ditulis gambar sumber yang ditentukan pada perangkat tampilan.

Mengembalikan nilai

Tidak ada

Keterangan

Pembatasan gambar sumber

Driver miniport tampilan harus mengikuti panduan ini ketika fungsi DxgkDdiSystemDisplayWrite dipanggil:

Format warna gambar sumber selalu dalam format D3DDDIFMT_R8G8B8 (24 bit per piksel) atau D3DDDIFMT_A8R8G8B8 (32 bpp) dari enumerasi D3DDDIFORMAT . Driver miniport tampilan sebelumnya telah mengatur mode tampilan untuk mengaktifkan operasi tulis dalam format ini ketika DxgkDdiSystemDisplayEnable dipanggil.
Gambar sumber berada dalam memori non-halaman. Driver miniport tampilan harus menulis gambar sumber ini ke buffer bingkai saat ini mulai dari posisi yang ditentukan oleh parameter PostionX dan PositionY .
Driver miniport tampilan harus menggunakan CPU untuk menulis blok gambar ke buffer bingkai. Ketika sistem mengalami kesalahan berhenti, itu mungkin disebabkan oleh deteksi dan pemulihan batas waktu berkelanjutan (TDR) pada perangkat tampilan. Dalam hal ini, unit pemrosesan grafis (GPU) mungkin dalam keadaan tidak diketahui.
Untuk informasi selengkapnya tentang TDR, lihat Deteksi dan Pemulihan Batas Waktu (TDR).

Gunakan memori non-halaman

Fungsi mode kernel Windows mungkin tidak tersedia saat fungsi ini sedang dipanggil.

DxgkDdiSystemDisplayWrite dapat dipanggil di IRQL apa pun, sehingga harus dalam memori yang tidak dapat dipelajari. DxgkDdiSystemDisplayWrite tidak boleh memanggil kode apa pun yang berada dalam memori yang dapat dipaginasi dan tidak boleh memanipulasi data apa pun yang berada dalam memori yang dapat di-pageable.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Target Platform	Desktop
Header	dispmprt.h
IRQL	Tingkat apa pun (lihat bagian Keterangan)