Estructura OEMCUIPPARAM (printoem.h)

La estructura OEMCUIPPARAM se usa como parámetro de entrada para el método IPrintOemUI::CommonUIProp de un complemento de interfaz de usuario.

Sintaxis

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;

Miembros

cbSize

Tamaño de la estructura OEMCUIPPARAM . Suministrado por el controlador Unidrv o Pscript5.

poemuiobj

Puntero a una estructura OEMUIOBJ .

hPrinter

Maneje la impresora. Suministrado por el controlador Unidrv o Pscript5.

pPrinterName

Cadena que contiene el nombre de la impresora. Suministrado por el controlador Unidrv o Pscript5.

hModule

Identificador del complemento de la interfaz de usuario. Suministrado por el controlador Unidrv o Pscript5.

hOEMHeap

Identificador de un montón desde el que se puede asignar espacio mediante una llamada a la función HeapAlloc (descrita en la documentación de Microsoft Windows SDK). Suministrado por el controlador Unidrv o Pscript5.

pPublicDM

Puntero a la estructura PÚBLICA DEVMODEW de la impresora. Válido solo si el argumento dwMode del método IPrintOemUI::CommonUIProp es OEMCUIP_DOCPROP. Suministrado por el controlador Unidrv o Pscript5.

pOEMDM

Puntero a los miembros privados de DEVMODEW del complemento de interfaz de usuario. Válido solo si el argumento dwMode del método IPrintOemUI::CommonUIProp es OEMCUIP_DOCPROP. Suministrado por el controlador Unidrv o Pscript5.

dwFlags

Para las llamadas a IPrintOemUI::CommonUIProp con su parámetro dwMode establecido en OEMCUIP_DOCPROP

Contiene el contenido del miembro fMode de la estructura DOCUMENTPROPERTYHEADER recibida por la función DrvDocumentPropertySheets del controlador de impresora.

Para las llamadas a IPrintOemUI::CommonUIProp con su parámetro dwMode establecido en OEMCUIP_PRNPROP

Contiene el contenido del miembro Flags de la estructura DEVICEPROPERTYHEADER recibida por la función DrvDevicePropertySheets del controlador de impresora.

pDrvOptItems

Puntero a la matriz OPTITEM del controlador de impresora. No es válida la primera vez que se llama a IPrintOemUI::CommonUIProp . Suministrado por el controlador Unidrv o Pscript5.

cDrvOptItems

Recuento de estructuras OPTITEM en la matriz a las que apunta pDrvOptItems. Suministrado por el controlador Unidrv o Pscript5.

pOEMOptItems

Puntero a una matriz de estructuras OPTITEM . Proporcionado por IPrintOemUI::CommonUIProp llamador. La segunda vez que se llama al método IPrintOemUI::CommonUIProp , debe colocar estructuras OPTITEM definidas por el complemento de interfaz de usuario en esta matriz y debe colocar el recuento de estructuras en cOEMOptItems. Para cada estructura OPTITEM colocada en la matriz, debe hacer lo siguiente:

• Establezca el miembro DMPubID de la estructura OPTITEM en uno de los valores predefinidos o en un valor mayor que DMPUB_USER. Si usa valores predefinidos, debe buscar en toda la matriz OPTITEM las estructuras que ya contienen esos valores y debe establecer sus marcas de OPTIF_HIDE.

• Asigne espacio para las estructuras OPTTYPES y OPTPARAMS mediante una llamada a la función HeapAlloc de Windows SDK mediante el identificador contenido en el miembro hOEMHeap de la estructura OEMCUIPPARAM. El controlador de impresora desasigna este espacio cuando ya no es necesario.

No es válida la primera vez que se llama a IPrintOemUI::CommonUIProp .

cOEMOptItems

Recuento de estructuras OPTITEM contenidas en la matriz apuntada por pOEMOptItems. Suministrado por el controlador Unidrv o Pscript5.

La primera vez que se llama al método IPrintOemUI::CommonUIProp , el valor proporcionado por el llamador para cOEMOptItems es cero. El método IPrintOemUI::CommonUIProp debe cambiar este valor para indicar el número de estructuras OPTITEM que proporciona el método. La segunda vez que se llama, IPrintOemUI::CommonUIProp debe proporcionar el número de estructuras OPTITEM agregadas realmente a la matriz a la que apunta pOEMOptItems.

pOEMUserData

Usado por el método IPrintOemUI::CommonUIProp , la segunda vez que se llama, para proporcionar la función OEMCUIPCallback con información de entrada adicional opcional.

OEMCUIPCallback

Usado por el método IPrintOemUI::CommonUIProp , la segunda vez que se llama, para devolver la dirección de una función de devolución de llamada de tipo OEMCUIPCALLBACK.

Comentarios

Un complemento de interfaz de usuario recibe la dirección de esta estructura como argumento de entrada para su método IPrintOemUI::CommonUIProp y su función de devolución de llamada con tipo OEMCUIPCALLBACK.

Para obtener información adicional sobre el uso de esta estructura y las funciones asociadas, vea Complementos de interfaz de usuario.

Requisitos

Requisito	Valor
Header	printoem.h (include Printoem.h)