Estrutura OEMCUIPPARAM (printoem.h)

A estrutura OEMCUIPPARAM é usada como um parâmetro de entrada para o método IPrintOemUI::CommonUIProp de um plug-in de interface do usuário.

Sintaxe

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;

Membros

cbSize

Tamanho da estrutura OEMCUIPPARAM . Fornecido pelo driver Unidrv ou Pscript5.

poemuiobj

Ponteiro para uma estrutura OEMUIOBJ .

hPrinter

Identificador para a impressora. Fornecido pelo driver Unidrv ou Pscript5.

pPrinterName

Cadeia de caracteres que contém o nome da impressora. Fornecido pelo driver Unidrv ou Pscript5.

hModule

Identificador para o plug-in da interface do usuário. Fornecido pelo driver Unidrv ou Pscript5.

hOEMHeap

Manipule para um heap do qual o espaço pode ser alocado chamando a função HeapAlloc (descrita na documentação do SDK do Microsoft Windows). Fornecido pelo driver Unidrv ou Pscript5.

pPublicDM

Ponteiro para a estrutura DEVMODEW pública da impressora. Válido somente se o argumento dwMode do método IPrintOemUI::CommonUIProp for OEMCUIP_DOCPROP. Fornecido pelo driver Unidrv ou Pscript5.

pOEMDM

Ponteiro para os membros DEVMODEW privados do plug-in de interface do usuário. Válido somente se o argumento dwMode do método IPrintOemUI::CommonUIProp for OEMCUIP_DOCPROP. Fornecido pelo driver Unidrv ou Pscript5.

dwFlags

Para chamadas para IPrintOemUI::CommonUIProp com seu parâmetro dwMode definido como OEMCUIP_DOCPROP

Contém o conteúdo do membro fMode da estrutura DOCUMENTPROPERTYHEADER recebida pela função DrvDocumentPropertySheets do driver da impressora.

Para chamadas para IPrintOemUI::CommonUIProp com seu parâmetro dwMode definido como OEMCUIP_PRNPROP

Contém o conteúdo do membro Flags da estrutura DEVICEPROPERTYHEADER recebida pela função DrvDevicePropertySheets do driver da impressora.

pDrvOptItems

Ponteiro para a matriz OPTITEM do driver de impressora. Não é válido na primeira vez que IPrintOemUI::CommonUIProp é chamado. Fornecido pelo driver Unidrv ou Pscript5.

cDrvOptItems

Contagem de estruturas OPTITEM na matriz apontada por pDrvOptItems. Fornecido pelo driver Unidrv ou Pscript5.

pOEMOptItems

Ponteiro para uma matriz de estruturas OPTITEM . Fornecido pelo chamador IPrintOemUI::CommonUIProp . Na segunda vez que o método IPrintOemUI::CommonUIProp é chamado, ele deve colocar estruturas OPTITEM definidas pelo plug-in da interface do usuário nessa matriz e deve colocar a contagem de estrutura em cOEMOptItems. Para cada estrutura OPTITEM colocada na matriz, você deve fazer o seguinte:

• Defina o membro DMPubID da estrutura OPTITEM como um dos valores predefinidos ou como um valor maior que DMPUB_USER. Se você usar valores predefinidos, deverá pesquisar toda a matriz OPTITEM em busca de estruturas que já contenham esses valores e definir seus sinalizadores de OPTIF_HIDE.

• Aloque espaço para estruturas OPTTYPES e OPTPARAMS chamando a função HeapAlloc do SDK do Windows, usando o identificador contido no membro hOEMHeap da estrutura OEMCUIPPARAM. O driver da impressora desaloca esse espaço quando ele não é mais necessário.

Não é válido na primeira vez que IPrintOemUI::CommonUIProp é chamado.

cOEMOptItems

Contagem de estruturas OPTITEM contidas na matriz apontada por pOEMOptItems. Fornecido pelo driver Unidrv ou Pscript5.

Na primeira vez que o método IPrintOemUI::CommonUIProp é chamado, o valor fornecido pelo chamador para cOEMOptItems é zero. O método IPrintOemUI::CommonUIProp deve alterar esse valor para indicar o número de estruturas OPTITEM fornecidas pelo método. Na segunda vez que é chamado, IPrintOemUI::CommonUIProp deve fornecer o número de estruturas OPTITEM realmente adicionadas à matriz apontada por pOEMOptItems.

pOEMUserData

Usado pelo método IPrintOemUI::CommonUIProp , a segunda vez que ele é chamado, para fornecer a função OEMCUIPCallback com informações de entrada extras opcionais.

OEMCUIPCallback

Usado pelo método IPrintOemUI::CommonUIProp , na segunda vez que é chamado, para retornar o endereço de uma função de retorno de chamada do tipo OEMCUIPCALLBACK.

Comentários

Um plug-in de interface do usuário recebe o endereço dessa estrutura como um argumento de entrada para seu método IPrintOemUI::CommonUIProp e sua função de retorno de chamada do tipo OEMCUIPCALLBACK.

Para obter informações adicionais sobre o uso dessa estrutura e funções associadas, consulte Plug-Ins da Interface do Usuário.

Requisitos

Requisito	Valor
Cabeçalho	printoem.h (inclua Printoem.h)