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

Artigo
02/07/2025

O método IPrintOemUni::EnablePDEV 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 de 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 cPatterns número 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 de GDIINFO.

cjDevInfo

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

pDevInfo

Ponteiro fornecido pelo chamador para uma estrutura de 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.)

Valor de retorno

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

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_FAIL	Falha na operação

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

Observações

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

O método IPrintOemUni::EnablePDEV 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 IPrintOemUni::EnablePDEV, a DLL de elementos gráficos de impressora da Undrv chamará o método de dentro de sua função DrvEnablePDEV.

O método IPrintOemUni::EnablePDEV 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 membro pdevOEM da estrutura DEVOBJ.

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

As estruturas apontadas pelos valores de parâmetro phsurfPatterns, pGdiInfoe 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 de DRVENABLEDATA apontada por 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 retornem às funções DDI de elementos gráficos do driver. Para obter mais informações, consulte funções DDI de elementos gráficos personalizados.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Partilhar via