Fungsi DrvResetPDEV (winddi.h)

Artikel
08/27/2023

Fungsi DrvResetPDEV memungkinkan driver grafis untuk mentransfer status driver dari struktur PDEV lama ke struktur PDEV baru ketika aplikasi Win32 memanggil ResetDC.

Sintaks

BOOL DrvResetPDEV(
  DHPDEV dhpdevOld,
  DHPDEV dhpdevNew
);

Parameter

dhpdevOld

Handel yang disediakan penelepon ke struktur PDEV perangkat asli. Handel ini sebelumnya disediakan oleh driver sebagai nilai pengembalian untuk DrvEnablePDEV.

dhpdevNew

Handel yang disediakan penelepon ke struktur PDEV baru.

Menampilkan nilai

Nilai pengembalian ini TRUE jika fungsi berhasil. Jika tidak, itu FALSE, dan kode kesalahan dicatat.

Keterangan

Fungsi DrvResetPDEV driver grafis harus digunakan untuk memodifikasi konten struktur PDEV baru, berdasarkan konten struktur PDEV lama (yang saat ini digunakan).

Driver tampilan OpenGL yang perlu diketahui tentang perubahan mode harus mengimplementasikan DrvResetPDEV. Jika tidak, semua driver tampilan lainnya biasanya tidak perlu menerapkan fungsi ini.

Catatan Informasi berikut berkaitan dengan DLL grafis printer.

Fungsi ini dipanggil sebagai akibat dari panggilan aplikasi ke fungsi Win32 ResetDC , yang pada gilirannya menyebabkan GDI memanggil DrvEnablePDEV driver untuk mendapatkan struktur PDEV baru. Karena driver dapat memodifikasi konten struktur PDEV selama penyajian pekerjaan cetak, fungsi DrvResetPDEV memungkinkan driver untuk mentransfer modifikasi ini dari struktur PDEV lama ke yang baru.

Contoh jenis informasi yang mungkin ingin ditambahkan DLL grafik printer ke struktur PDEV baru adalah penunjuk ke file font yang di-cache, atau bendera yang menunjukkan apakah inisialisasi halaman harus (atau tidak) terjadi lain kali DrvStartDoc atau DrvStartPage dipanggil.

Jika ResetDC dipanggil selama penyajian dokumen cetak, DLL grafis printer menerima urutan panggilan berikut:

    dhpdevNew = DrvEnablePDEV();
    DrvResetPDEV(dhpdevOld, dhpdevNew);
    DrvDisableSurface(dhpdevOld);
    DrvDisablePDEV(dhpdevOld);
    DrvEnableSurface(dhpdevNew);
    DrvStartDoc(dhpdevNew);

Jika ResetDC dipanggil di antara dokumen tidak ada permukaan yang terkait dengan PDEV, jadi hanya urutan panggilan berikut yang dilakukan:

    dhpdevNew = DrvEnablePDEV();
    DrvResetPDEV(dhpdevOld,dhpdevNew);
    DrvDisablePDEV(dhpdevOld);

Persyaratan


Target Platform	Desktop
Header	winddi.h (termasuk Winddi.h)

Lihat juga