Struttura OEMCUIPPARAM (printoem.h)

Articolo
02/29/2024

La struttura OEMCUIPPARAM viene usata come parametro di input per un plug-in dell'interfaccia utente IPrintOemUI::CommonUIProp .

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;

Members

cbSize

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

poemuiobj

Puntatore a una struttura OEMUIOBJ .

hPrinter

Gestire la stampante. Fornito dal driver Unidrv o Pscript5.

pPrinterName

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

hModule

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

hOEMHeap

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

pPublicDM

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

pOEMDM

Puntatore ai membri privati di DEVMODEW dell'interfaccia utente. Valido solo se l'argomento dwMode del metodo IPrintOemUI::CommonUIProp è OEMCUIP_DOCPROP. 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 DrvDocumentPropertySheets del driver della stampante.

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

Contiene il contenuto del membro Flag della struttura DEVICEPROPERTYHEADER ricevuta dalla funzione DrvDevicePropertySheets del driver della stampante.

pDrvOptItems

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

cDrvOptItems

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

pOEMOptItems

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

Impostare il membro DMPubID della struttura OPTITEM su uno dei valori predefiniti o su un valore maggiore di DMPUB_USER. Se si usano valori predefiniti, è necessario cercare l'intera matrice OPTITEM per le strutture già contenenti tali valori e è necessario impostare i flag di OPTIF_HIDE.
Allocare spazio per le strutture OPTTYPES e OPTPARAMS chiamando la funzione HeapAlloc 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 valido la prima volta che viene chiamato IPrintOemUI::CommonUIProp .

cOEMOptItems

Numero di strutture OPTITEM contenute nella matrice puntata da 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 chiamata, IPrintOemUI::CommonUIProp deve fornire il numero di strutture OPTITEM effettivamente aggiunte alla matrice puntata da 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.

Commenti

Un plug-in dell'interfaccia utente riceve l'indirizzo di questa struttura come argomento di input sia per il metodo IPrintOemUI::CommonUIProp che per la relativa funzione di callback OEMCUIPCALLBACK.

Per altre informazioni sull'uso di questa struttura e sulle funzioni associate, vedere Plug-In dell'interfaccia utente.

Requisiti

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

Share via