Fungsi GdiGetDevmodeForPage (winppi.h)

  • Artikel

Fungsi GdiGetDevmodeForPage mengembalikan struktur DEVMODEW untuk halaman yang ditentukan dan sebelumnya dari pekerjaan cetak.

Sintaks

BOOL GdiGetDevmodeForPage(
  HANDLE    SpoolFileHandle,
  DWORD     dwPageNumber,
  PDEVMODEW *pCurrDM,
  PDEVMODEW *pLastDM
);

Parameter

SpoolFileHandle

Handel file penampung yang disediakan penelepon, diperoleh dengan panggilan sebelumnya ke GdiGetSpoolFileHandle.

dwPageNumber

Nomor yang disediakan penelepon dari halaman tempat konten DEVMODEW akan dikembalikan.

pCurrDM

Lokasi yang disediakan penelepon untuk menerima penunjuk ke struktur DEVMODE untuk halaman yang ditentukan oleh dwPageNumber.

pLastDM

Lokasi yang disediakan penelepon untuk menerima penunjuk ke struktur DEVMODE untuk halaman sebelumnya dengan yang ditentukan oleh dwPageNumber.

Mengembalikan nilai

Jika operasi berhasil, fungsi mengembalikan TRUE. Jika tidak, ia mengembalikan FALSE.

Keterangan

Fungsi GdiGetDevmodeForPage diekspor oleh gdi32.dll untuk digunakan dalam fungsi PrintDocumentOnPrintProcessor prosesor cetak.

Sebelum memanggil GdiPlayPageEMF untuk menjalankan instruksi EMF halaman, prosesor cetak harus memanggil GdiGetDevmodeForPage untuk menentukan apakah struktur DEVMODE yang terkait dengan halaman yang akan dicetak sama dengan halaman terakhir yang dicetak. Jika dua struktur DEVMODE yang dikembalikan tidak identik, prosesor cetak harus melakukan langkah-langkah berikut, secara berurutan, sebelum memanggil GdiPlayPageEMF untuk halaman:

  1. Hubungi GdiEndPageEMF.
  2. Panggil GdiResetDCEMF, menentukan DEVMODE yang ditunjukkan oleh pCurrDM.
  3. Panggil GdiStartPageEMF.
Untuk informasi tambahan, lihat Menggunakan Fungsi GDI di Prosesor Cetak.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header winppi.h (termasuk Winppi.h)
Pustaka Gdi32.Lib
DLL Gdi32.dll