IPrintOemUI::Metode GetInfo (prcomoem.h)

Artikel
08/07/2023

Metode plug-in IPrintOemUI::GetInfo antarmuka pengguna 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_GETREQUESTEDHELPERINTERFACES

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

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 anggota pOEMOptItems struktur OEMCUIPPARAM.

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 antarmuka pengguna diperlukan untuk mengimplementasikan IPrintOemUI::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.

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

Persyaratan

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

Lihat juga

IPrintOemPS::GetInfo

IPrintOemUI

IPrintOemUni::GetInfo

Bagikan melalui