Metodo IPrintOemUni2::WritePrinter (prcomoem.h)

Il IPrintOemUni2::WritePrinter metodo, se supportato, consente a un plug-in di rendering di acquisire tutti i dati di output generati da un driver Unidrv. Se questo metodo non è supportato, i dati di output verrebbero altrimenti inviati allo spooler in una chiamata all'API WritePrinter dello spooler (descritta nella documentazione di Microsoft Windows SDK).

Sintassi

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

Parametri

pdevobj

Puntatore a una struttura DEVOBJ .

pBuf

Puntatore al primo byte di una matrice di byte che contiene i dati di output generati dal driver Unidrv.

cbBuffer

Specifica le dimensioni, in byte, della matrice a cui punta pBuf.

pcbWritten

Puntatore a un valore DWORD che riceve il numero di byte di dati inviati correttamente al plug-in.

Valore restituito

In caso di esito positivo, questo metodo restituisce S_OK. In caso contrario, questo metodo deve restituire un valore appropriato nel valore HRESULT restituito.

Commenti

Al momento di DrvEnablePDEV , il driver Unidrv chiama questo metodo con pBuf e pdevobj impostato su NULL e cbBuf impostato su 0, per rilevare se il plug-in implementa questa funzione. Il plug-in deve restituire S_OK per indicare che implementa questo metodo e deve restituire E_NOTIMPL in caso contrario.

Questo metodo deve segnalare il numero di byte scritti nella funzione WritePrinter dello spooler in pcbWritten. Un valore pari a zero non porta alcun significato speciale; gli errori devono essere segnalati tramite HRESULT restituito.

Il IPrintOemUni2::WritePrinter metodo è facoltativo. Se un plug-in per il rendering implementa questo metodo, il metodo IPrintOemUni::GetImplementedMethod del plug-in deve restituire S_OK quando riceve "WritePrinter" come input.

Requisiti