Metodo IPrintOemUni::GetInfo (prcomoem.h)

Il metodo del plug-in di IPrintOemUni::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_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 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 dwInfo.

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.

Commenti

Un plug-in di rendering per Unidrv deve implementare il IPrintOemUni::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.

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::GetInfo

IPrintOemUI::GetInfo

IPrintOemUni