Metode IPrintOemDriverUI::D rvGetDriverSetting (prcomoem.h)

Metode IPrintOemDriverUI::DrvGetDriverSetting ini disediakan oleh minidriver Unidrv dan Pscript5 sehingga plug-in antarmuka pengguna dapat memperoleh status fitur printer saat ini dan informasi internal lainnya.

Sintaks

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

Parameter

pci

Penunjuk yang disediakan penelepon ke struktur OEMUIOBJ .

Feature

Nilai yang disediakan pemanggil yang mengidentifikasi fitur printer tempat pengaturan opsi 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

Saat memanggil IPrintOemDriverUI::DrvGetDriverSetting metode , plug-in antarmuka pengguna dapat menentukan penunjuk string atau nilai konstanta untuk pFeatureKeyword.

• Jika pFeatureKeyword adalah string, pFeatureKeyword harus mewakili salah satu hal berikut:
  • Nama fitur yang ditentukan dalam file GPD minidriver Unidrv , atau,
  • Argumen kata kunci ke entri *OpenUI dalam file PPD minidriver Pscript5.

  Metode mengembalikan satu atau beberapa string yang dihentikan NULL dalam buffer yang ditunjukkan oleh pOutput. Setiap string mewakili nama opsi yang saat ini dipilih. Jumlah string dikembalikan dalam pdwOptionsReturned.

• Jika pFeatureKeyword adalah konstanta, itu harus menjadi salah satu konstanta awalan OEMGDS_ yang ditentukan dalam printoem.h. Metode mengembalikan nilai yang ditunjukkan oleh konstanta yang ditentukan dengan menempatkannya di buffer yang ditunjukkan oleh pOutput. Nilai yang dikembalikan dalam pdwOptionsReturned selalu 1.

Persyaratan

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