IPrintOemPS::Metode GetInfo (prcomoem.h)

Artikel
08/07/2023

Metode plug-in penyajian IPrintOemPS::GetInfo mengembalikan informasi identifikasi.

Sintaks

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

Parameter

dwMode

Berisi salah satu konstanta bilangan bulat yang disediakan penelepon berikut.

OEMGI_GETPUBLISHERINFO

Metode harus menunjukkan apakah plug-in penyajian akan menggunakan "mode penerbitan". Parameter pBuffer menunjuk ke struktur PUBLISHERINFO , yang akan diisi dengan metode . Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

OEMGI_GETREQUESTEDHELPERINTERFACES

Metode harus menulis nilai bendera bit OEMPUBLISH_IPRINTCOREHELPER ke buffer pBuffer jika metode IPrintOemPS::P ublishDriverInterface harus dipanggil dengan parameter pIUnknown yang menunjuk ke objek yang mengimplementasikan Antarmuka IPrintCoreHelperPS.

OEMGI_GETSIGNATURE

Metode harus mengembalikan tanda tangan identifikasi empat byte yang unik. Plug-in juga harus menempatkan tanda tangan ini dalam struktur OPTITEM , seperti yang dijelaskan dalam deskripsi OEMCUIPPARAM. anggota pOEMOptItems struktur.

OEMGI_GETVERSION

Metode harus mengembalikan nomor versi plug-in antarmuka pengguna sebagai DWORD. Format versi ditentukan pengembang.

pBuffer

Penunjuk yang disediakan penelepon ke memori yang dialokasikan untuk menerima informasi yang ditentukan oleh dwMode.

cbSize

Ukuran buffer yang disediakan penelepon yang diacu oleh pBuffer.

pcbNeeded

Penunjuk yang disediakan penelepon ke lokasi untuk menerima jumlah byte yang ditulis ke dalam buffer yang ditujukkan oleh pBuffer.

Nilai kembali

Metode harus mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
E_FAIL	Operasi gagal
E_NOTIMPL	Metode ini tidak diterapkan.

Keterangan

Plug-in rendering untuk Pscript5 diperlukan untuk mengimplementasikan IPrintOemPS::GetInfo metode , yang dipanggil segera setelah plug-in dimuat. Metode harus mengembalikan informasi yang ditentukan dengan menuliskannya ke alamat yang ditentukan oleh pBuffer dan menulis ukuran, dalam byte, dari informasi yang dikembalikan ke lokasi yang ditentukan oleh pcbNeeded.

Jika pBufferADALAH NULL, metode hanya boleh menggunakan pcbNeeded untuk mengembalikan jumlah byte yang diperlukan untuk menyimpan informasi yang ditentukan.

Dalam "mode penerbitan", semua informasi font yang akan diunduh ditempatkan di header pekerjaan. Setiap font diunduh hanya sekali dan dapat digunakan untuk halaman mana pun, memungkinkan pekerjaan menjadi independen urutan halaman. Jika dwMode OEMGI_GETPUBLISHERINFO tetapi plug-in tidak mendukung mode penerbitan, IPrintOemPS::GetInfo harus mengembalikan E_NOTIMPL.

Untuk informasi selengkapnya tentang membuat dan menginstal plug-in penyajian, lihat Menyesuaikan Driver Printer Microsoft.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	prcomoem.h (termasuk Prcomoem.h)

Lihat juga

IPrintOemPS

IPrintoemUI::GetInfo

IPrintOemUni::GetInfo

Bagikan melalui