Struktur OEMCUIPPARAM (printoem.h)

Struktur OEMCUIPPARAM digunakan sebagai parameter input untuk metode IPrintOemUI::CommonUIProp plug-in antarmuka pengguna.

Sintaks

typedef struct _OEMCUIPPARAM {
  DWORD           cbSize;
  POEMUIOBJ       poemuiobj;
  HANDLE          hPrinter;
  PWSTR           pPrinterName;
  HANDLE          hModule;
  HANDLE          hOEMHeap;
  PDEVMODE        pPublicDM;
  PVOID           pOEMDM;
  DWORD           dwFlags;
  POPTITEM        pDrvOptItems;
  DWORD           cDrvOptItems;
  POPTITEM        pOEMOptItems;
  DWORD           cOEMOptItems;
  PVOID           pOEMUserData;
  OEMCUIPCALLBACK OEMCUIPCallback;
} *POEMCUIPPARAM, OEMCUIPPARAM;

Anggota

cbSize

Ukuran struktur OEMCUIPPARAM . Disediakan oleh driver Unidrv atau Pscript5.

poemuiobj

Penunjuk ke struktur OEMUIOBJ .

hPrinter

Tangani ke pencetak. Disediakan oleh driver Unidrv atau Pscript5.

pPrinterName

String yang berisi nama printer. Disediakan oleh driver Unidrv atau Pscript5.

hModule

Tangani ke plug-in antarmuka pengguna. Disediakan oleh driver Unidrv atau Pscript5.

hOEMHeap

Tangani ke timbunan dari mana ruang dapat dialokasikan dengan memanggil fungsi HeapAlloc (dijelaskan dalam dokumentasi Microsoft Windows SDK). Disediakan oleh driver Unidrv atau Pscript5.

pPublicDM

Arahkan ke struktur DEVMODEW publik printer. Hanya berlaku jika argumen dwMode metode IPrintOemUI::CommonUIProp adalah OEMCUIP_DOCPROP. Disediakan oleh driver Unidrv atau Pscript5.

pOEMDM

Arahkan ke anggota DEVMODEW privat plug-in antarmuka pengguna. Hanya berlaku jika argumen dwMode metode IPrintOemUI::CommonUIProp adalah OEMCUIP_DOCPROP. Disediakan oleh driver Unidrv atau Pscript5.

dwFlags

Untuk panggilan ke IPrintOemUI::CommonUIProp dengan parameter dwMode-nya diatur ke OEMCUIP_DOCPROP

Berisi isi anggota fMode dari struktur DOCUMENTPROPERTYHEADER yang diterima oleh fungsi DrvDocumentPropertySheets driver printer.

Untuk panggilan ke IPrintOemUI::CommonUIProp dengan parameter dwMode-nya diatur ke OEMCUIP_PRNPROP

Berisi isi anggota Bendera dari struktur DEVICEPROPERTYHEADER yang diterima oleh fungsi DrvDevicePropertySheets driver printer.

pDrvOptItems

Penunjuk ke array OPTITEM driver printer. Tidak valid saat pertama kali IPrintOemUI::CommonUIProp dipanggil. Disediakan oleh driver Unidrv atau Pscript5.

cDrvOptItems

Jumlah struktur OPTITEM dalam array yang diacu oleh pDrvOptItems. Disediakan oleh driver Unidrv atau Pscript5.

pOEMOptItems

Penunjuk ke array struktur OPTITEM . Disediakan oleh penelepon IPrintOemUI::CommonUIProp . Kedua kalinya metode IPrintOemUI::CommonUIProp dipanggil, metode harus menempatkan struktur OPTITEM yang ditentukan oleh plug-in antarmuka pengguna dalam array ini, dan harus menempatkan jumlah struktur di cOEMOptItems. Untuk setiap struktur OPTITEM yang ditempatkan dalam array, Anda harus melakukan hal berikut:

• Atur anggota DMPubID struktur OPTITEM baik ke salah satu nilai yang telah ditentukan sebelumnya atau ke nilai yang lebih besar dari DMPUB_USER. Jika Anda menggunakan nilai yang telah ditentukan sebelumnya, Anda harus mencari seluruh array OPTITEM untuk struktur yang sudah berisi nilai tersebut, dan Anda harus mengatur bendera OPTIF_HIDE mereka.

• Alokasikan ruang untuk struktur OPTTYPES dan OPTPARAMS dengan memanggil fungsi Windows SDK HeapAlloc , menggunakan handel yang terkandung dalam anggota hOEMHeap struktur OEMCUIPPARAM. Pengandar pencetak membatalkan alokasi ruang ini ketika tidak lagi diperlukan.

Tidak valid saat pertama kali IPrintOemUI::CommonUIProp dipanggil.

cOEMOptItems

Jumlah struktur OPTITEM yang terkandung dalam array yang diacu oleh pOEMOptItems. Disediakan oleh driver Unidrv atau Pscript5.

Pertama kali metode IPrintOemUI::CommonUIProp dipanggil, nilai yang disediakan pemanggil untuk cOEMOptItems adalah nol. Metode IPrintOemUI::CommonUIProp harus mengubah nilai ini untuk menunjukkan jumlah struktur OPTITEM yang disediakan metode. Kedua kalinya dipanggil, IPrintOemUI::CommonUIProp harus menyediakan jumlah struktur OPTITEM yang benar-benar ditambahkan ke array yang diacu oleh pOEMOptItems.

pOEMUserData

Digunakan oleh metode IPrintOemUI::CommonUIProp , kedua kalinya dipanggil, untuk memberikan fungsi OEMCUIPCallback dengan informasi input tambahan opsional.

OEMCUIPCallback

Digunakan oleh metode IPrintOemUI::CommonUIProp , kedua kalinya dipanggil, untuk mengembalikan alamat fungsi panggilan balik jenis OEMCUIPCALLBACK.

Keterangan

Plug-in antarmuka pengguna menerima alamat struktur ini sebagai argumen input ke metode IPrintOemUI::CommonUIProp dan fungsi panggilan balik yang di ketik OEMCUIPCALLBACK.

Untuk informasi tambahan tentang penggunaan struktur ini dan fungsi terkait, lihat Plug-In Antarmuka Pengguna.

Persyaratan

Persyaratan	Nilai
Header	printoem.h (termasuk Printoem.h)