Método IPrintOemPS2::WritePrinter (prcomoem.h)

Artigo
02/07/2025

O método IPrintOemPS2::WritePrinter, se compatível, permite que um plug-in de renderização capture todos os dados de saída gerados por um driver Postscript. Se esse método não tiver suporte, os dados de saída serão enviados para o spooler em uma chamada para a API do WritePrinter do spooler (descrito na documentação do SDK do Microsoft Windows).

Sintaxe

HRESULT WritePrinter(
  PDEVOBJ pdevobj,
  PVOID   pBuf,
  DWORD   cbBuffer,
  PDWORD  pcbWritten
);

Parâmetros

pdevobj

Ponteiro para uma estrutura de DEVOBJ.

pBuf

Ponteiro para o primeiro byte de uma matriz de bytes que contém os dados de saída gerados pelo driver PostScript.

cbBuffer

Especifica o tamanho, em bytes, da matriz apontada por pBuf.

pcbWritten

Ponteiro para um valor DWORD que recebe o número de bytes de dados que o plug-in enviou para a função WritePrinter do spooler (descrito na documentação do SDK do Windows).

Valor de retorno

Se tiver êxito, esse método retornará S_OK. Caso contrário, esse método deve retornar um valor apropriado no HRESULT retornado.

Observações

Em tempo DrvEnablePDEV, o driver PostScript chama esse método com pBuf e pdevobj definido como NULL e cbBuf definido como 0, para detectar se o plug-in implementa essa função. O plug-in deve retornar S_OK para indicar que implementa esse método e deve retornar E_NOTIMPL caso contrário.

Esse método deve relatar o número de bytes gravados na função WritePrinter do spooler em pcbWritten. Um valor de zero não tem nenhum significado especial; os erros devem ser relatados por meio do HRESULT retornado.

Requisitos

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

Compartilhar via