Metodo IPrintOemDriverUI::D rvGetDriverSetting (prcomoem.h)

Articolo
02/29/2024

Il IPrintOemDriverUI::DrvGetDriverSetting metodo viene fornito dai minidriver Unidrv e Pscript5 in modo che i plug-in dell'interfaccia utente possano ottenere lo stato corrente delle funzionalità della stampante e altre informazioni interne.

Sintassi

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

Parametri

pci

Puntatore fornito dal chiamante a una struttura OEMUIOBJ .

Feature

Valore fornito dal chiamante che identifica la funzionalità della stampante per cui vengono 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 si chiama il metodo, un plug-in dell'interfaccia IPrintOemDriverUI::DrvGetDriverSetting utente può specificare un puntatore stringa o un valore costante per pFeatureKeyword.

Se pFeatureKeyword è una stringa, deve rappresentare uno dei seguenti elementi:
- Nome di funzionalità specificato in un file GPD unidrv minidriver o
- Argomento parola chiave per una voce *OpenUI in un file PPD di Pscript5.
Il metodo restituisce una o più stringhe con terminazione NULL nel buffer a cui fa riferimento pOutput. Ogni stringa rappresenta il nome di un'opzione attualmente selezionata. Il numero di stringhe viene restituito in pdwOptionsReturned.
Se pFeatureKeyword è una costante, deve essere una delle costanti con prefisso OEMGDS_ definite in printoem.h. Il metodo restituisce il valore indicato dalla costante specificata inserendolo nel buffer a cui punta da pOutput. Il valore restituito in pdwOptionsReturned è sempre 1.

Requisiti

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

Condividi tramite