Metodo IPrintOemUI::QueryColorProfile (prcomoem.h)

Il IPrintOemUI::QueryColorProfile metodo consente a un plug-in dell'interfaccia utente di specificare un profilo CPI da usare per la gestione dei colori.

Sintassi

HRESULT QueryColorProfile(
  HANDLE    hPrinter,
  POEMUIOBJ poemuiobj,
  PDEVMODE  pPublicDM,
  PVOID     pOEMDM,
  ULONG     ulQueryMode,
  VOID      *pvProfileData,
  ULONG     *pcbProfileData,
  FLONG     *pflProfileData
);

Parametri

hPrinter

Handle stampante fornito dal chiamante.

poemuiobj

Puntatore fornito dal chiamante a una struttura OEMUIOBJ .

pPublicDM

Puntatore fornito dal chiamante a una struttura DEVMODEW convalidata.

pOEMDM

Puntatore fornito dal chiamante ai membri della struttura DEVMODEW privati del plug-in dell'interfaccia utente.

ulQueryMode

Uno dei flag di bit forniti dal chiamante seguente, che indica il tipo di profilo da specificare.

Flag	Definizione
QCP_DEVICEPROFILE	Il chiamante richiede un profilo del dispositivo.
QCP_SOURCEPROFILE	Il chiamante richiede un profilo di origine.

pvProfileData

Puntatore fornito dal chiamante a un buffer per ricevere informazioni sul profilo.

pcbProfileData

Puntatore fornito dal chiamante a un valore che rappresenta le dimensioni, in byte, del buffer a cui punta pvProfileData.

pflProfileData

Uno dei flag di bit forniti dal metodo seguenti, che indica il tipo di informazioni restituite dal metodo.

Flag	Definizione
QCP_PROFILEDISK	Il metodo restituisce il nome file di un profilo ICC nel buffer a cui punta pvProfileData.
QCP_PROFILEMEMORY	Il metodo restituisce i dati del profilo nel buffer a cui punta pvProfileData.

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

Il metodo del plug-in di IPrintOemUI::QueryColorProfile un'interfaccia utente esegue gli stessi tipi di operazioni della funzione DrvQueryColorProfile esportata dalle DLL dell'interfaccia della stampante in modalità utente. Per informazioni sugli eventi della stampante e su come devono essere elaborati, vedere la descrizione della funzione DrvQueryColorProfile .

Se si specifica un plug-in dell'interfaccia utente, la funzione DrvQueryColorProfile del driver della stampante chiama il IPrintOemUI::QueryColorProfile metodo . La funzione DrvQueryColorProfile esegue la propria elaborazione per l'evento specificato e quindi chiama il IPrintOemUI::QueryColorProfile metodo per gestire l'elaborazione aggiuntiva dell'evento.

Se IPrintOemUI::QueryColorProfile i metodi vengono esportati da più plug-in dell'interfaccia utente, i metodi vengono chiamati nell'ordine in cui vengono specificati i plug-in per l'installazione.

Per altre informazioni sulla creazione e l'installazione di plug-in dell'interfaccia utente, vedere Personalizzazione dei driver della stampante microsoft.

Requisiti

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