Metodo IPrintOemPS::GetInfo (prcomoem.h)
Il metodo di IPrintOemPS::GetInfo di un plug-in di rendering restituisce informazioni di identificazione.
Sintassi
HRESULT GetInfo(
DWORD dwMode,
PVOID pBuffer,
DWORD cbSize,
PDWORD pcbNeeded
);
Parametri
dwMode
Contiene una delle costanti integer fornite dal chiamante seguenti.
OEMGI_GETPUBLISHERINFO
Il metodo deve indicare se il plug-in di rendering usa la "modalità di pubblicazione". Il parametro pBuffer punta a una struttura PUBLISHERINFO, da compilare con il metodo . Per altre informazioni, vedere la sezione Osservazioni seguente.
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 di OPTITEM, come descritto nella descrizione del 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
Dimensione fornita 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 riuscita. |
|
Operazione non riuscita |
|
Il metodo non è implementato. |
Osservazioni
I plug-in di rendering per Pscript5 sono necessari per implementare il metodo IPrintOemPS::GetInfo, 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 di Microsoft.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | prcomoem.h (include Prcomoem.h) |