Struttura OEMCUIPPARAM (printoem.h)

Articolo
02/07/2025

La struttura OEMCUIPPARAM viene usata come parametro di input per il metodo IPrintOemUI::CommonUIProp di un'interfaccia utente.

Sintassi

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;

Membri

cbSize

Dimensioni della struttura OEMCUIPPARAM. Fornito dal driver Unidrv o Pscript5.

poemuiobj

Puntatore a una struttura OEMUIOBJ.

hPrinter

Handle per la stampante. Fornito dal driver Unidrv o Pscript5.

pPrinterName

Stringa contenente il nome della stampante. Fornito dal driver Unidrv o Pscript5.

hModule

Handle per il plug-in dell'interfaccia utente. Fornito dal driver Unidrv o Pscript5.

hOEMHeap

Handle in un heap da cui è possibile allocare spazio chiamando la funzione HeapAlloc (descritta nella documentazione di Microsoft Windows SDK). Fornito dal driver Unidrv o Pscript5.

pPublicDM

Puntatore alla struttura di DEVMODEW pubblica della stampante. Valido solo se l'OEMCUIP_DOCPROP argomento dwMode del metodo IPrintOemUI::CommonUIProp. Fornito dal driver Unidrv o Pscript5.

pOEMDM

Puntatore ai membri DEVMODE W privati del plug-in dell'interfaccia utente. Valido solo se l'OEMCUIP_DOCPROP argomento dwMode del metodo IPrintOemUI::CommonUIProp. Fornito dal driver Unidrv o Pscript5.

dwFlags

Per le chiamate a IPrintOemUI::CommonUIProp con il parametro dwMode impostato su OEMCUIP_DOCPROP

Contiene il contenuto del membro fMode della struttura DOCUMENTPROPERTYHEADER ricevuta dalla funzione DrvDocumentPropertySheet s del driver della stampante.

Per le chiamate a IPrintOemUI::CommonUIProp con il parametro dwMode impostato su OEMCUIP_PRNPROP

Contiene il contenuto del Flags membro della struttura DEVICEPROPERTYHEADER ricevuto dalla funzione DrvDevicePropertySheets del driver della stampante.

pDrvOptItems

Puntatore alla matrice di OPTITEM del driver della stampante. Non valida la prima volta che viene chiamato IPrintOemUI::CommonUIProp. Fornito dal driver Unidrv o Pscript5.

cDrvOptItems

Numero di strutture OPTITEM nella matrice a cui punta pDrvOptItems. Fornito dal driver Unidrv o Pscript5.

pOEMOptItems

Puntatore a una matrice di strutture OPTITEM. Fornito dal chiamante IPrintOemUI::CommonUI Prop. La seconda volta che viene chiamato il metodo IPrintOemUI::CommonUIProp, deve posizionare strutture OPTITEM definite dal plug-in dell'interfaccia utente in questa matrice e deve inserire il conteggio delle strutture in cOEMOptItems. Per ogni struttura OPTITEM inserita nella matrice, è necessario eseguire le operazioni seguenti:

Impostare il membro DMPubID della struttura OPT ITEM o su un valore maggiore di DMPUB_USER. Se si usano valori predefiniti, è necessario eseguire una ricerca nell'intera matrice OPTITEM per le strutture che contengono già tali valori ed è necessario impostare i flag OPTIF_HIDE.
Allocare spazio per le strutture di OPTTYPES e OPTPARAMS chiamando la funzione HeapAl loc di Windows SDK, usando l'handle contenuto nel membro hOEMHeap della struttura OEMCUIPPARAM. Il driver della stampante dealloca questo spazio quando non è più necessario.

Non valida la prima volta che viene chiamato IPrintOemUI::CommonUIProp.

cOEMOptItems

Numero di strutture OPTITEM contenute nella matrice a cui punta pOEMOptItems. Fornito dal driver Unidrv o Pscript5.

La prima volta che viene chiamato il metodo IPrintOemUI::CommonUIProp, il valore fornito dal chiamante per cOEMOptItems è zero. Il metodo IPrintOemUI::CommonUIProp deve modificare questo valore per indicare il numero di strutture OPTITEM fornite dal metodo. La seconda volta che viene chiamato, IPrintOemUI::CommonUIProp deve fornire il numero di strutture OPTITEM effettivamente aggiunte alla matrice a cui punta pOEMOptItems.

pOEMUserData

Usato dal metodo IPrintOemUI::CommonUIProp, la seconda volta che viene chiamato, per fornire la funzione OEMCUIPCallback con informazioni di input aggiuntive facoltative.

OEMCUIPCallback

Usato dal metodo IPrintOemUI::CommonUIProp, la seconda volta che viene chiamato, per restituire l'indirizzo di una funzione di callback di tipo OEMCUIPCALLBACK.

Osservazioni

Un plug-in dell'interfaccia utente riceve l'indirizzo di questa struttura come argomento di input sia per il metodo IPrintOemUI::CommonUIProp che per il relativo OEMCUIPCALLBACKfunzione di callback tipizzata.

Per altre informazioni sull'uso di questa struttura e delle funzioni associate, vedere plug-in dell'interfaccia utente.

Fabbisogno

Requisito	Valore
intestazione	printoem.h (include Printoem.h)

Condividi tramite