DrvQueryColorProfile-Funktion (winddiui.h)

Artikel
02/07/2025

Die DrvQueryColorProfile--Funktion ermöglicht es einer Druckerschnittstellen-DLL, ein ICC-Profil anzugeben, das für die Farbverwaltung verwendet werden soll.

Syntax

BOOL DrvQueryColorProfile(
        HANDLE    hPrinter,
  [in]  PDEVMODEW pdevmode,
        ULONG     ulQueryMode,
  [out] VOID      *pvProfileData,
  [out] ULONG     *pcbProfileData,
  [out] FLONG     *pflProfileData
);

Parameter

hPrinter

Vom Anrufer bereitgestellter Druckerhandle.

[in] pdevmode

Vom Aufrufer bereitgestellter Zeiger auf eine DEVMODEW--Struktur.

ulQueryMode

Eines der folgenden vom Aufrufer bereitgestellten Bit-Flags, die den Typ des anzugebenden Profils angibt.

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

[out] pvProfileData

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

[out] pcbProfileData

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

[out] pflProfileData

Eines der folgenden von der Funktion bereitgestellten Bitkennzeichnungen, die den Typ der Informationen angibt, die die Funktion zurückgibt.

Flagge	Definition
QCP_PROFILEDISK	Die Funktion gibt den Dateinamen eines ICC-Profils im Puffer zurück, auf den pvProfileDataverweist.
QCP_PROFILEMEMORY	Die Funktion gibt Profildaten im Puffer zurück, auf die durch pvProfileData-verwiesen wird.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion TRUEzurück; andernfalls wird FALSE-zurückgegeben.

Bemerkungen

Eine Druckerschnittstellen-DLL- kann optional eine DrvQueryColorProfile--Funktion bereitstellen. Wenn die Funktion bereitgestellt wird, ruft GDI sie auf, wenn ICM für einen Druckauftrag aktiviert wurde. Der Zweck der Funktion besteht darin, ein ICC-Profil zu bestimmen und anzugeben, das für die Verwendung mit dem Druckauftrag geeignet ist.

Wenn die Druckerschnittstellen-DLL eines Treibers keine DrvQueryColorProfile--Funktion bereitstellt oder wenn die Funktion FALSE-zurückgibt, versucht GDI, ein Profil zu finden. Weitere Informationen finden Sie unter Suchen von ICC-Profilen.

Wenn die durch pcbProfileData- angegebene Ausgabepuffergröße zu klein ist, sollte der Treiber den von pcbProfileData angegebenen Größenwert mit der erforderlichen Puffergröße überschreiben, SetLastError(ERROR_INSUFFICIENT_BUFFER) aufrufen und FALSE-zurückgeben.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	winddiui.h (include Winddiui.h)

Freigeben über