Metode IPrintOemDriverPS::D rvGetDriverSetting (prcomoem.h)

Artikel
03/01/2024

Metode IPrintOemDriverPS::DrvGetDriverSetting ini disediakan oleh driver Pscript5 sehingga plug-in penyajian dapat memperoleh status fitur printer saat ini dan informasi internal lainnya.

Sintaks

HRESULT DrvGetDriverSetting(
  PVOID  pdriverobj,
  PCSTR  Feature,
  PVOID  pOutput,
  DWORD  cbSize,
  PDWORD pcbNeeded,
  PDWORD pdwOptionsReturned
);

Parameter

pdriverobj

Penunjuk yang disediakan penelepon ke struktur DEVOBJ .

Feature

Nilai yang disediakan pemanggil yang mengidentifikasi fitur printer yang pengaturan opsinya akan dikembalikan. Ini bisa berupa penunjuk string atau konstanta, seperti yang dijelaskan di bagian Keterangan berikut.

pOutput

Penunjuk yang disediakan penelepon ke buffer untuk menerima informasi yang ditentukan.

cbSize

Ukuran yang disediakan penelepon, dalam byte, dari buffer yang diacu oleh pOutput.

pcbNeeded

Penunjuk yang disediakan penelepon ke lokasi untuk menerima ukuran buffer minimum yang diperlukan untuk memuat informasi yang diminta.

pdwOptionsReturned

Penunjuk yang disediakan penelepon ke lokasi untuk menerima jumlah string opsi yang ditempatkan di pOutput.

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

Ketika metode dipanggil IPrintOemDriverPS::DrvGetDriverSetting , baik penunjuk string atau nilai konstanta dapat ditentukan untuk pFeatureKeyword.

Jika pFeatureKeyword adalah string, itu harus mewakili argumen kata kunci ke entri *OpenUI dalam file PPD minidriver Pscript5.
Metode harus mengembalikan satu atau beberapa string yang dihentikan NULL dalam buffer yang ditunjukkan oleh pOutput. Setiap string harus mewakili nama opsi yang saat ini dipilih. Jumlah string harus dikembalikan dalam pdwOptionsReturned.
Jika pFeatureKeyword adalah konstanta, itu harus menjadi salah satu konstanta awalan OEMGDS_ yang ditentukan dalam printoem.h. Metode harus mengembalikan nilai yang ditunjukkan oleh konstanta yang ditentukan dengan menempatkannya di buffer yang ditunjukkan oleh pOutput. Nilai yang dikembalikan dalam pdwOptionsReturned harus 1.

Persyaratan

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

Bagikan melalui