Metodo IPrintCoreUI2::D rvGetDriverSetting (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintCoreUI2::DrvGetDriverSetting viene fornito dal driver Pscript5 di Windows XP 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

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

pcbNeeded

Puntatore fornito dal chiamante a una posizione per ricevere la dimensione minima del buffer necessaria 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 riuscita.
E_FAIL	Operazione non riuscita.
E_NOTIMPL	Il metodo non è implementato.

Osservazioni

Questo metodo viene ereditato dal IPrintOemDriverUI COM Interfacee 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 principale, ed è supportato durante la IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets e le relative routine di callback del foglio delle proprietà. Quando questo metodo è supportato, ha lo stesso comportamento di IPrintOemDriverUI::D rvGetDriverSetting. Se non è supportato, questo metodo deve restituire E_NOTIMPL.