Metodo IPrintOemUI::QueryColorProfile (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintOemUI::QueryColorProfile consente a un plug-in dell'interfaccia utente di specificare un profilo ICC 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 di 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.

Bandiera	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.

Bandiera	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 riuscita.
E_FAIL	Operazione non riuscita.
E_NOTIMPL	Il metodo non è implementato.

Osservazioni

Il metodo di IPrintOemUI::QueryColorProfile di un'interfaccia utente esegue gli stessi tipi di operazioni del DrvQueryColorProfile funzione 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, il driver della stampante DrvQueryColorProfile funzione chiama il metodo IPrintOemUI::QueryColorProfile. La funzione DrvQueryColorProfile esegue la propria elaborazione per l'evento specificato e quindi chiama il metodo IPrintOemUI::QueryColorProfile per gestire l'elaborazione aggiuntiva dell'evento.

Se IPrintOemUI::QueryColorProfile 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 di Microsoft.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	prcomoem.h (include Prcomoem.h)

Condividi tramite