Metodo IPrintOemUni2::WritePrinter (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintOemUni2::WritePrinter, 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 in HRESULT restituito.

Osservazioni

Al momento DrvEnablePDEV, il driver Unidrv chiama questo metodo con pBuf e pdevobj impostato su NULLe 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 di WritePrinter dello spooler in pcbWritten. Un valore pari a zero non comporta alcun significato speciale; gli errori devono essere segnalati tramite HRESULT restituito.

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	prcomoem.h (include Prcomoem.h)

Condividi tramite