Método IPrintOemUni::EnablePDEV (prcomoem.h)

  • Artigo

O IPrintOemUni::EnablePDEV método permite que um plug-in de renderização para Unidrv crie sua própria estrutura PDEV.

Sintaxe

HRESULT EnablePDEV(
        PDEVOBJ       pdevobj,
        PWSTR         pPrinterName,
        ULONG         cPatterns,
        HSURF         *phsurfPatterns,
        ULONG         cjGdiInfo,
        GDIINFO       *pGdiInfo,
        ULONG         cjDevInfo,
        DEVINFO       *pDevInfo,
        DRVENABLEDATA *pded,
  [out] OUT PDEVOEM   *pDevOem
);

Parâmetros

pdevobj

Ponteiro fornecido pelo chamador para uma estrutura DEVOBJ .

pPrinterName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres de texto que representa o endereço lógico da impressora.

cPatterns

Valor fornecido pelo chamador que representa o número de identificadores de superfície do tipo HSURF contidos no buffer apontado por phsurfPatterns.

phsurfPatterns

Ponteiro fornecido pelo chamador para um buffer grande o suficiente para conter o número cPatterns de identificadores de superfície do tipo HSURF. As alças representam padrões de preenchimento de superfície.

cjGdiInfo

Valor fornecido pelo chamador que representa o tamanho da estrutura apontada por pGdiInfo.

pGdiInfo

Ponteiro fornecido pelo chamador para uma estrutura GDIINFO .

cjDevInfo

Valor fornecido pelo chamador que representa o tamanho da estrutura apontada por pDevInfo.

pDevInfo

Ponteiro fornecido pelo chamador para uma estrutura DEVINFO .

pded

Ponteiro fornecido pelo chamador para uma estrutura DRVENABLEDATA que contém os endereços das funções de conexão DDI de elementos gráficos do driver de impressora. Para obter mais informações, consulte a seção Comentários a seguir.

[out] pDevOem

Recebe um ponteiro fornecido pelo método para uma estrutura PDEV privada. (Para obter mais informações, consulte a seção Comentários a seguir.)

Retornar valor

O método deve retornar um dos valores a seguir.

Código de retorno Descrição
S_OK
 A operação foi realizada com êxito.
E_FAIL
 Falha na operação
 

Se a operação falhar, o método deverá chamar SetLastError para definir um código de erro.

Comentários

Um plug-in de renderização para Unidrv deve implementar o IPrintOemUni::EnablePDEV método .

O IPrintOemUni::EnablePDEV método executa os mesmos tipos de operações que a função DrvEnablePDEV exportada por uma DLL de gráficos de impressora. Sua finalidade é permitir que um plug-in de renderização crie sua própria estrutura PDEV. (Para obter mais informações sobre estruturas PDEV, consulte Estruturas PDEV personalizadas.)

Se você fornecer um plug-in de renderização que exporta o método , a IPrintOemUni::EnablePDEV DLL de elementos gráficos da impressora undrv chamará o método de dentro de sua função DrvEnablePDEV .

O IPrintOemUni::EnablePDEV método deve alocar uma instância de sua estrutura PDEV privada, inicializá-la e retornar seu endereço como o parâmetro pDevOem do método. Outros métodos de plug-in recebem o endereço como o membro pdevOEM da estrutura DEVOBJ .

O membro pdevOEM da estrutura DEVOBJ não é usado com o IPrintOemUni::EnablePDEV método .

As estruturas apontadas pelos valores de parâmetro phsurfPatterns, pGdiInfo e pDevInfo são as mesmas que a função DrvEnablePDEV da Unidrv recebe. O plug-in de renderização pode modificar o conteúdo da estrutura conforme necessário. Ele pode fornecer padrões de preenchimento de superfície obtendo alças de superfície do tipo HSURF e colocando-os no buffer apontado por phsurfPatterns. Tipos de padrão de preenchimento e ordem de identificador são listados na descrição de DrvEnablePDEV.

A estrutura DRVENABLEDATA apontada pelo pded contém os endereços das funções DDI gráficas fornecidas pela DLL de elementos gráficos da impressora Unidrv. Você tem permissão para fornecer funções de conexão personalizadas em seu plug-in para essas funções DDI gráficas. O conteúdo da estrutura DRVENABLEDATA permite que suas funções de conexão personalizadas chamem de volta para as funções DDI de elementos gráficos do driver. Para obter mais informações, consulte Funções DDI de gráficos personalizados.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)