Metodo IPrintOemPS::GetInfo (prcomoem.h)

Il metodo del plug-in di IPrintOemPS::GetInfo rendering restituisce informazioni di identificazione.

Sintassi

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

Parametri

dwMode

Contiene una delle seguenti costanti integer fornite dal chiamante.

OEMGI_GETPUBLISHERINFO

Il metodo deve indicare se il plug-in per il rendering usa la "modalità di pubblicazione". Il parametro pBuffer punta a una struttura PUBLISHERINFO , da compilare tramite il metodo . Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

OEMGI_GETREQUESTEDHELPERINTERFACES

Il metodo deve scrivere il valore del flag di bit di OEMPUBLISH_IPRINTCOREHELPER nel buffer pBuffer se il metodo IPrintOemPS::P ublishDriverInterface deve essere chiamato con il parametro pIUnknown che punta a un oggetto che implementa l'interfaccia IPrintCoreHelperPS.

OEMGI_GETSIGNATURE

Il metodo deve restituire una firma di identificazione a quattro byte univoca. Il plug-in deve anche inserire questa firma nelle strutture OPTITEM , come descritto nella descrizione di OEMCUIPPARAM. membro pOEMOptItems della struttura.

OEMGI_GETVERSION

Il metodo deve restituire il numero di versione del plug-in dell'interfaccia utente come DWORD. Il formato della versione è definito dallo sviluppatore.

pBuffer

Puntatore fornito dal chiamante alla memoria allocata per ricevere le informazioni specificate da dwMode.

cbSize

Dimensioni fornite dal chiamante del buffer a cui punta pBuffer.

pcbNeeded

Puntatore fornito dal chiamante a una posizione per ricevere il numero di byte scritti nel buffer a cui punta pBuffer.

Valore restituito

Il metodo deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_FAIL	Operazione non riuscita
E_NOTIMPL	Il metodo non è implementato.

Commenti

I plug-in di rendering per Pscript5 sono necessari per implementare il IPrintOemPS::GetInfo metodo , che viene chiamato immediatamente dopo il caricamento del plug-in. Il metodo deve restituire le informazioni specificate scrivendolo nell'indirizzo specificato da pBuffer e scrivendo le dimensioni, in byte, delle informazioni restituite nella posizione specificata da pcbNeeded.

Se pBuffer è NULL, il metodo deve usare solo pcbNeeded per restituire il numero di byte necessari per archiviare le informazioni specificate.

In modalità di pubblicazione tutte le informazioni sul tipo di carattere da scaricare vengono inserite nell'intestazione del processo. Ogni tipo di carattere viene scaricato una sola volta e può essere usato per qualsiasi pagina, consentendo al processo di essere indipendente dall'ordine di pagina. Se dwMode è OEMGI_GETPUBLISHERINFO ma il plug-in non supporta la modalità di pubblicazione, IPrintOemPS::GetInfo deve restituire E_NOTIMPL.

Per altre informazioni sulla creazione e l'installazione di plug-in di rendering, vedere Personalizzazione dei driver della stampante microsoft.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	prcomoem.h (include Prcomoem.h)

Vedi anche

IPrintOemPS

IPrintOemUI::GetInfo

IPrintOemUni::GetInfo