Metodo IPrintCoreUI2::D rvGetDriverSetting (prcomoem.h)

Articolo
02/29/2024

Il IPrintCoreUI2::DrvGetDriverSetting metodo viene fornito dal driver Windows XP Pscript5 in modo che i plug-in dell'interfaccia utente Pscript5 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. Può trattarsi di un puntatore di stringa o di una costante, come descritto nella sezione Osservazioni seguente.

pOutput

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

cbSize

Dimensione fornita dal chiamante, in byte, del buffer a cui punta 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 inserite in pOutput.

Valore restituito

Questo 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

Questo metodo viene ereditato dall'interfaccia COM IPrintOemDriverUI e può essere chiamato solo dai plug-in windows XP e versioni successive dell'interfaccia utente Pscript5 che non sostituiscono completamente le pagine dell'interfaccia utente standard del driver di base ed è supportato durante le routine di callback del plug-in dell'interfaccia utente IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets . Quando questo metodo è supportato, ha lo stesso comportamento di IPrintOemDriverUI::D rvGetDriverSetting. Quando non è supportato, questo metodo deve restituire E_NOTIMPL.