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 のプリンター ドライバーのカスタマイズ」を参照してください。

要件

要件 値
対象プラットフォーム デスクトップ
Header prcomoem.h (Prcomoem.h を含む)