次の方法で共有

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 を含む)