Metodo IPrintOemDriverUni::D rvGetDriverSetting (prcomoem.h)

  • Articolo

Il IPrintOemDriverUni::DrvGetDriverSetting metodo viene fornito dal driver Unidrv in modo che i plug-in di rendering possano ottenere lo stato corrente delle funzionalità della stampante e altre informazioni interne.

Sintassi

HRESULT DrvGetDriverSetting(
  PVOID  pdriverobj,
  PCSTR  Feature,
  PVOID  pOutput,
  DWORD  cbSize,
  PDWORD pcbNeeded,
  PDWORD pdwOptionsReturned
);

Parametri

pdriverobj

Puntatore fornito dal chiamante a una struttura DEVOBJ .

Feature

Il chiamante ha fornito valore che identifica la funzionalità della stampante per cui verranno restituite le impostazioni delle opzioni. Questo può essere un puntatore di stringa o una costante, come descritto nella sezione Osservazioni seguenti.

pOutput

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

cbSize

Dimensioni fornite dal chiamante, in byte, del buffer a cui fa riferimento pOutput.

pcbNeeded

Puntatore fornito dal chiamante a una posizione per ricevere le dimensioni minime del buffer necessarie per contenere le informazioni richieste.

pdwOptionsReturned

Puntatore fornito dal chiamante a una posizione per ricevere il numero di stringhe di opzione posizionate in pOutput.

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

Quando viene chiamato il IPrintOemDriverUni::DrvGetDriverSetting metodo, è possibile specificare un puntatore di stringa o un valore costante per pFeatureKeyword.

  • Se pFeatureKeyword è una stringa, deve rappresentare un nome di funzionalità specificato in un file GPD di minidriver Unidrv

    Il metodo deve restituire una o più stringhe con terminazione NULL nel buffer a cui punta da pOutput. Ogni stringa deve rappresentare il nome di un'opzione attualmente selezionata. Il numero di stringhe deve essere restituito in pdwOptionsReturned.

  • Se pFeatureKeyword è una costante, deve essere una delle costanti con prefisso OEMGDS_ definite in printoem.h. Il metodo deve restituire il valore indicato dalla costante specificata inserendolo nel buffer a cui fa riferimento pOutput. Il valore restituito in pdwOptionsReturned deve essere 1.

Requisiti

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