Metodo IPrintOemDriverUni::D rvGetGPDData (prcomoem.h)

  • Articolo

Il IPrintOemDriverUni::DrvGetGPDData metodo viene fornito dal driver Unidrv in modo che i plug-in di rendering possano ottenere i dati definiti nel file GPD di una stampante.

Sintassi

HRESULT DrvGetGPDData(
  PDEVOBJ pdevobj,
  DWORD   dwType,
  PVOID   pInputData,
  PVOID   pBuffer,
  DWORD   cbSize,
  PDWORD  pcbNeeded
);

Parametri

pdevobj

Puntatore fornito dal chiamante a una struttura DEVOBJ .

dwType

Flag fornito dal chiamante che indica il tipo di dati GPD richiesti. Attualmente, il flag seguente è l'unico definito:

Flag Definizione
GPD_OEMCUSTOMDATA Il metodo restituisce la stringa associata alla voce *OEMCustomData di un file GPD.

pInputData

Riservato. Deve essere zero.

pBuffer

Puntatore fornito dal chiamante a un buffer per ricevere le informazioni richieste.

cbSize

Dimensioni fornite dal chiamante, in byte, del buffer a cui punta pBuffer.

pcbNeeded

Riceve le dimensioni minime del buffer fornite dal driver, in byte, necessarie per contenere le informazioni richieste.

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

Se il buffer specificato da pBuffer e cbSize è troppo piccolo per ricevere le informazioni richieste, Unidrv fornisce le dimensioni del buffer necessarie nella posizione puntata da pcbNeeded, restituisce E_FAIL e imposta il codice di errore su ERROR_INSUFFICIENT_BUFFER.

Requisiti

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