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 |
|---|---|
|
Operazione completata. |
|
Operazione non riuscita |
|
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) |