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

O IPrintOemUni2::WritePrinter método, se compatível, permite que um plug-in de renderização capture todos os dados de saída gerados por um driver Unidrv. 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 WritePrinter do spooler (descrita 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 DEVOBJ .

pBuf

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

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 foram enviados com êxito para o plug-in.

Retornar valor

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

Comentários

No momento drvEnablePDEV , o driver Unidrv chama esse método com pBuf e pdevobj definidos 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 no pcbWritten. Um valor zero não tem nenhum significado especial; os erros devem ser relatados por meio do HRESULT retornado.

O IPrintOemUni2::WritePrinter método é opcional. Se um plug-in de renderização implementar esse método, o método IPrintOemUni::GetImplementedMethod do plug-in deverá retornar S_OK quando receber "WritePrinter" como entrada.

Requisitos

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