次の方法で共有

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 プロファイルの検索」を参照してください。

pcbProfileData で指定された出力バッファー サイズが小さすぎる場合、ドライバーは、pcbProfileData によって提供されるサイズ値を必要なバッファー サイズで上書きし、SetLastError(ERROR_INSUFFICIENT_BUFFER) を呼び出し、FALSE 返す必要があります。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー winddiui.h (Winddiui.h を含む)