Структура OEMCUIPPARAM (printoem.h)

Статья
08/07/2023

Структура OEMCUIPPARAM используется в качестве входного параметра метода IPrintOemUI::CommonUIProp подключаемого модуля пользовательского интерфейса.

Синтаксис

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;

Члены

cbSize

Размер структуры OEMCUIPPARAM . Предоставляется драйвером Unidrv или Pscript5.

poemuiobj

Указатель на структуру OEMUIOBJ .

hPrinter

Дескриптор к принтеру. Предоставляется драйвером Unidrv или Pscript5.

pPrinterName

Строка, содержащая имя принтера. Предоставляется драйвером Unidrv или Pscript5.

hModule

Обработка подключаемого модуля пользовательского интерфейса. Предоставляется драйвером Unidrv или Pscript5.

hOEMHeap

Выполните обработку кучи, из которой можно выделить пространство, вызвав функцию HeapAlloc (описанную в документации по Microsoft Windows SDK). Предоставляется драйвером Unidrv или Pscript5.

pPublicDM

Указатель на общедоступную структуру DEVMODEW принтера. Допустимо, только если аргумент dwMode метода IPrintOemUI::CommonUIProp OEMCUIP_DOCPROP. Предоставляется драйвером Unidrv или Pscript5.

pOEMDM

Указатель на частные члены DEVMODEW подключаемого модуля пользовательского интерфейса. Допустимо, только если аргумент dwMode метода IPrintOemUI::CommonUIProp OEMCUIP_DOCPROP. Предоставляется драйвером Unidrv или Pscript5.

dwFlags

Для вызовов IPrintOemUI::CommonUIProp с параметром dwMode, для параметра OEMCUIP_DOCPROP

Содержит содержимое элемента fMode структуры DOCUMENTPROPERTYHEADER, полученного функцией DrvDocumentPropertySheets драйвера принтера.

Для вызовов IPrintOemUI::CommonUIProp с параметром dwMode, заданным OEMCUIP_PRNPROP

Содержит содержимое элемента Flags структуры DEVICEPROPERTYHEADER, полученного функцией DrvDevicePropertySheets драйвера принтера.

pDrvOptItems

Указатель на массив OPTITEM драйвера принтера. Недопустимо при первом вызове IPrintOemUI::CommonUIProp . Предоставляется драйвером Unidrv или Pscript5.

cDrvOptItems

Количество структур OPTITEM в массиве, на который указывает pDrvOptItems. Предоставляется драйвером Unidrv или Pscript5.

pOEMOptItems

Указатель на массив структур OPTITEM . Предоставляется вызывающим объектом IPrintOemUI::CommonUIProp . При втором вызове метода IPrintOemUI::CommonUIProp он должен поместить структуры OPTITEM , определенные подключаемым модулем пользовательского интерфейса, в этот массив, а количество структур должно поместиться в cOEMOptItems. Для каждой структуры OPTITEM, размещенной в массиве, необходимо выполнить следующие действия:

Присвойте члену DMPubID структуры OPTITEM одно из предопределенных значений или значение, превышающее DMPUB_USER. Если вы используете какие-либо предопределенные значения, необходимо выполнить поиск по всему массиву OPTITEM для структур, уже содержащих эти значения, и задать их флаги OPTIF_HIDE.
Выделите пространство для структур OPTTYPES и OPTPARAMS , вызвав функцию HeapAlloc пакета Windows SDK, используя дескриптор, содержащийся в элементе hOEMHeap структуры OEMCUIPPARAM. Драйвер принтера освобождает это пространство, когда оно больше не требуется.

Недопустимо при первом вызове IPrintOemUI::CommonUIProp .

cOEMOptItems

Количество структур OPTITEM, содержащихся в массиве, на который указывает pOEMOptItems. Предоставляется драйвером Unidrv или Pscript5.

При первом вызове метода IPrintOemUI::CommonUIProp заданное вызывающим элементом значение для cOEMOptItems равно нулю. Метод IPrintOemUI::CommonUIProp должен изменить это значение, чтобы указать количество структур OPTITEM, которые предоставляет метод. При втором вызове IPrintOemUI::CommonUIProp должен предоставить количество структур OPTITEM, фактически добавленных в массив, на который указывает pOEMOptItems.

pOEMUserData

Используется методом IPrintOemUI::CommonUIProp во второй раз, чтобы предоставить функции OEMCUIPCallback необязательные дополнительные входные сведения.

OEMCUIPCallback

Используется методом IPrintOemUI::CommonUIProp ( при втором вызове) для возврата адреса функции обратного вызова типа OEMCUIPCALLBACK.

Подключаемый модуль пользовательского интерфейса получает адрес этой структуры в качестве входного аргумента для метода IPrintOemUI::CommonUIProp и функции обратного вызова OEMCUIPCALLBACK.

Дополнительные сведения об использовании этой структуры и связанных функций см. в разделе Подключаемые модули пользовательского интерфейса.

Требования

Требование	Значение
Заголовок	printoem.h (включая Printoem.h)

Поделиться через