Metodo IPrintOemUni::GetInfo (prcomoem.h)
Il metodo di IPrintOemUni::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_GETREQUESTEDHELPERINTERFACES
Il metodo deve scrivere il valore del flag di bit di OEMPUBLISH_IPRINTCOREHELPER nel buffer pBuffer se il metodo IPrintOemUni::P ublishDriverInterface deve essere chiamato con il parametro pIUnknown che punta a un oggetto che implementa l'interfaccia IPrintCoreHelperUni.
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 dwInfo.
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. |
Osservazioni
Un plug-in di rendering per Unidrv deve implementare il metodo IPrintOemUni::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.
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) |