共用方式為

IPrintOemUI：：QueryColorProfile 方法 (prcomoem.h)

  • 發行項

方法 IPrintOemUI::QueryColorProfile 可讓使用者介面外掛程式指定要用於色彩管理的 ICC 配置檔。

語法

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

參數

hPrinter

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

poemuiobj

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

pPublicDM

呼叫端提供的指標指向已驗證 的 DEVMODEW 結構。

pOEMDM

呼叫端提供的指標，指向使用者介面外掛程式的私人 DEVMODEW 結構成員。

ulQueryMode

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

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

pvProfileData

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

pcbProfileData

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

pflProfileData

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

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

傳回值

方法必須傳回下列其中一個值。

傳回碼 描述
S_OK
 作業成功。
E_FAIL
 作業失敗。
E_NOTIMPL
 此方法尚未實作。

備註

使用者介面外掛程式的 IPrintOemUI::QueryColorProfile 方法會執行與使用者模式印表機介面 DLL 所匯出 之 DrvQueryColorProfile 函式相同的作業類型。 如需印表機事件及其處理方式的相關信息，請參閱 DrvQueryColorProfile 函式的描述。

如果您提供使用者介面外掛程式，印表機驅動程式的 DrvQueryColorProfile 函式會呼叫 IPrintOemUI::QueryColorProfile 方法。 DrvQueryColorProfile 函式會針對指定的事件執行自己的處理，然後呼叫 IPrintOemUI::QueryColorProfile 方法來處理事件的其他處理。

如果 IPrintOemUI::QueryColorProfile 多個使用者介面外掛程式匯出方法，則會依指定外掛程式安裝的順序呼叫方法。

如需建立及安裝使用者介面外掛程式的詳細資訊，請參閱 自定義 Microsoft 的印表機驅動程式。

規格需求

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