OEMCUIPPARAM-Struktur (printoem.h)

Artikel
02/07/2025

Die OEMCUIPPARAM--Struktur wird als Eingabeparameter für die IPrintOemUI::CommonUIProp--Methode eines Benutzeroberflächen-Plug-Ins verwendet.

Syntax

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;

Angehörige

cbSize

Größe der OEMCUIPPARAM Struktur. Wird vom Unidrv- oder Pscript5-Treiber bereitgestellt.

poemuiobj

Zeiger auf eine OEMUIOBJ--Struktur.

hPrinter

Behandeln Sie den Drucker. Wird vom Unidrv- oder Pscript5-Treiber bereitgestellt.

pPrinterName

Zeichenfolge, die den Druckernamen enthält. Wird vom Unidrv- oder Pscript5-Treiber bereitgestellt.

hModule

Behandeln Sie das Plug-In für die Benutzeroberfläche. Wird vom Unidrv- oder Pscript5-Treiber bereitgestellt.

hOEMHeap

Handle to a heap from which space can be allocated by calling the HeapAlloc function (described in the Microsoft Windows SDK documentation). Wird vom Unidrv- oder Pscript5-Treiber bereitgestellt.

pPublicDM

Zeiger auf die öffentliche DEVMODEW Struktur des Druckers. Nur gültig, wenn das Argument "IPrintOemUI::CommonUIProp" Methode dwMode OEMCUIP_DOCPROP ist. Wird vom Unidrv- oder Pscript5-Treiber bereitgestellt.

pOEMDM

Zeiger auf das private DEVMODEW--Member des Benutzeroberflächen-Plug-Ins. Nur gültig, wenn das Argument "IPrintOemUI::CommonUIProp" Methode dwMode OEMCUIP_DOCPROP ist. Wird vom Unidrv- oder Pscript5-Treiber bereitgestellt.

dwFlags

Für Aufrufe von IPrintOemUI::CommonUIProp, wobei der dwMode-Parameter auf OEMCUIP_DOCPROP

Enthält den Inhalt des fMode- Members der DOCUMENTPROPERTYHEADER Struktur, die von der DrvDocumentPropertySheets--Funktion des Druckertreibers empfangen wurde.

Für Aufrufe an IPrintOemUI::CommonUIProp, wobei der dwMode-Parameter auf OEMCUIP_PRNPROP

Enthält den Inhalt des Flags Member der DEVICEPROPERTYHEADER-Struktur, die vom DrvDevicePropertySheets Funktion des Druckertreibers empfangen wird.

pDrvOptItems

Zeiger auf das OPTITEM Array des Druckertreibers. Ungültig, wenn IPrintOemUI::CommonUIProp- zum ersten Mal aufgerufen wird. Wird vom Unidrv- oder Pscript5-Treiber bereitgestellt.

cDrvOptItems

Anzahl der OPTITEM-Strukturen im Array, auf das von pDrvOptItemsverwiesen wird. Wird vom Unidrv- oder Pscript5-Treiber bereitgestellt.

pOEMOptItems

Zeiger auf ein Array von OPTITEM- Strukturen. Bereitgestellt von IPrintOemUI::CommonUIProp Aufrufer. Wenn die IPrintOemUI::CommonUIProp--Methode aufgerufen wird, muss sie OPTITEM- Strukturen platzieren, die durch das Benutzeroberflächen-Plug-In in diesem Array definiert sind, und sie muss die Strukturanzahl in cOEMOptItemsplatzieren. Für jede OPTITEM-Struktur, die im Array platziert wird, müssen Sie folgendes tun:

Legen Sie die OPTITEMDMPubID Element entweder auf einen der vordefinierten Werte oder auf einen Wert fest, der größer als DMPUB_USER ist. Wenn Sie vordefinierte Werte verwenden, müssen Sie das gesamte OPTITEM Array nach Strukturen durchsuchen, die diese Werte bereits enthalten, und Sie müssen deren OPTIF_HIDE Flags festlegen.
Weisen Sie Platz für OPTTYPES- und OPTPARAMS- Strukturen zu, indem Sie die Windows SDK-HeapAlloc--Funktion aufrufen, indem Sie das Handle verwenden, das im hOEMHeap Member der OEMCUIPPARAM-Struktur enthalten ist. Der Druckertreiber stellt diesen Speicherplatz frei, wenn er nicht mehr benötigt wird.

Ungültig, wenn IPrintOemUI::CommonUIProp- zum ersten Mal aufgerufen wird.

cOEMOptItems

Anzahl der OPTITEM-Strukturen, die in dem Array enthalten sind, das von pOEMOptItems. Wird vom Unidrv- oder Pscript5-Treiber bereitgestellt.

Wenn die IPrintOemUI::CommonUIProp--Methode zum ersten Mal aufgerufen wird, ist der vom Aufrufer bereitgestellte Wert für cOEMOptItems null. Die IPrintOemUI::CommonUIProp Methode muss diesen Wert ändern, um die Anzahl der OPTITEM-Strukturen anzugeben, die die Methode bereitstellt. Beim zweiten Aufruf muss IPrintOemUI::CommonUIProp die Anzahl der OPTITEM-Strukturen liefern, die tatsächlich dem Array hinzugefügt wurden, auf das pOEMOptItemsverweist.

pOEMUserData

Wird von der IPrintOemUI::CommonUIProp--Methode verwendet, um die OEMCUIPCallback- funktion mit optionalen zusätzlichen Eingabeinformationen bereitzustellen.

OEMCUIPCallback

Wird von der IPrintOemUI::CommonUIProp--Methode verwendet, um die Adresse einer Rückruffunktion vom Typ OEMCUIPCALLBACKzurückzugeben.

Bemerkungen

Ein Benutzeroberflächen-Plug-In empfängt die Adresse dieser Struktur als Eingabeargument für die IPrintOemUI::CommonUIProp--Methode und die OEMCUIPCALLBACK-typed callback function.

Weitere Informationen zur Verwendung dieser Struktur und der zugehörigen Funktionen finden Sie unter User Interface Plug-Ins.

Anforderungen

Anforderung	Wert
Header-	printoem.h (include Printoem.h)

Freigeben über