drvQueryColorProfile 函式 (winddiui.h)

DrvQueryColorProfile 函式可讓印表機介面 DLL 指定要用於色彩管理的 ICC 配置檔。

語法

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

參數

hPrinter

呼叫端提供的印表機句柄。

[in] pdevmode

呼叫端提供的 DEVMODEW 結構的指標。

ulQueryMode

下列其中一個呼叫端提供的位旗標，指出要指定的配置檔類型。

旗標	定義
QCP_DEVICEPROFILE	呼叫端正在要求裝置配置檔。
QCP_SOURCEPROFILE	呼叫端正在要求來源配置檔。

[out] pvProfileData

呼叫端提供的緩衝區指標，以接收配置文件資訊。

[out] pcbProfileData

呼叫端提供的指標，代表 pvProfileData 所指向之緩衝區的大小，以位元組為單位。

[out] pflProfileData

下列其中一個函式提供的位旗標，指出函式所傳回的信息類型。

旗標	定義
QCP_PROFILEDISK	函式會傳回 pvProfileData 所指向緩衝區中之 ICC 配置檔的檔名。
QCP_PROFILEMEMORY	函式會傳回 pvProfileData 所指向緩衝區中的配置檔數據。

傳回值

如果作業成功，函式會傳回 TRUE;否則會傳回 FALSE。

備註

印表機介面 DLL 可以選擇性地提供DrvQueryColorProfile函式。 如果提供函式，GDI 會在已針對列印作業啟用ICM時呼叫它。 函式的目的是要判斷並指定適合用於列印作業的 ICC 配置檔。

如果驅動程式的印表機介面 DLL 未提供DrvQueryColorProfile函式，或函式傳回 FALSE，GDI 會嘗試尋找設定檔。 如需詳細資訊，請參閱 尋找 ICC 設定檔。

如果 由 azureProfileData 指定的輸出緩衝區大小太小，則驅動程式應該以所需的緩衝區大小覆寫 (ERROR_INSUFFICIENT_BUFFER) ， 並傳回 FALSE。

規格需求

需求	值
目標平台	桌面
標頭	winddiui.h (包含Winddiui.h)