IPrintOemUI::QueryColorProfile-Methode (prcomoem.h)

Artikel
08/07/2023

Die IPrintOemUI::QueryColorProfile -Methode ermöglicht es einem Benutzeroberflächen-Plug-In, ein ICC-Profil anzugeben, das für die Farbverwaltung verwendet werden soll.

Syntax

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

Parameter

hPrinter

Vom Anrufer bereitgestellter Druckerhandle.

poemuiobj

Vom Aufrufer bereitgestellter Zeiger auf eine OEMUIOBJ-Struktur .

pPublicDM

Vom Aufrufer bereitgestellter Zeiger auf eine überprüfte DEVMODEW-Struktur .

pOEMDM

Vom Aufrufer bereitgestellter Zeiger auf die privaten DEVMODEW-Strukturmember des Benutzeroberflächen-Plug-Ins.

ulQueryMode

Eines der folgenden vom Aufrufer bereitgestellten Bitflags, die den Typ des anzugebenden Profils angibt.

Flag	Definition
QCP_DEVICEPROFILE	Der Aufrufer fordert ein Geräteprofil an.
QCP_SOURCEPROFILE	Der Aufrufer fordert ein Quellprofil an.

pvProfileData

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer zum Empfangen von Profilinformationen.

pcbProfileData

Vom Aufrufer bereitgestellter Zeiger auf einen Wert, der die Größe des Puffers in Bytes darstellt, auf den pvProfileData verweist.

pflProfileData

Eines der folgenden von der Methode bereitgestellten Bitflags, das den Typ der Von der Methode zurückgegebenen Informationen angibt.

Flag	Definition
QCP_PROFILEDISK	Die -Methode gibt den Dateinamen eines ICC-Profils im Puffer zurück, auf den von pvProfileData verwiesen wird.
QCP_PROFILEMEMORY	Die -Methode gibt Profildaten im Puffer zurück, auf den von pvProfileData verwiesen wird.

Rückgabewert

Die -Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt.
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Die Methode ist nicht implementiert.

Hinweise

Die Methode eines Benutzeroberflächen-Plug-Ins IPrintOemUI::QueryColorProfile führt dieselben Arten von Vorgängen wie die DrvQueryColorProfile-Funktion aus, die von Benutzermodus-Druckerschnittstellen-DLLs exportiert wird. Informationen zu Druckerereignissen und deren Verarbeitung finden Sie in der Beschreibung der DrvQueryColorProfile-Funktion .

Wenn Sie ein Benutzeroberflächen-Plug-In bereitstellen, ruft die DrvQueryColorProfile-Funktion des Druckertreibers die IPrintOemUI::QueryColorProfile -Methode auf. Die DrvQueryColorProfile-Funktion führt eine eigene Verarbeitung für das angegebene Ereignis aus und ruft dann die -Methode auf, um die IPrintOemUI::QueryColorProfile zusätzliche Verarbeitung des Ereignisses zu verarbeiten.

Wenn IPrintOemUI::QueryColorProfile Methoden von mehreren Benutzeroberflächen-Plug-Ins exportiert werden, werden die Methoden in der Reihenfolge aufgerufen, in der die Plug-Ins für die Installation angegeben werden.

Weitere Informationen zum Erstellen und Installieren von Benutzeroberflächen-Plug-Ins finden Sie unter Anpassen der Druckertreiber von Microsoft.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	prcomoem.h (include Prcomoem.h)

Freigeben über