DevQueryPrintEx 関数 (winddiui.h)

プリンター インターフェイス DLL の DevQueryPrintEx 関数は、指定された印刷ジョブがプリンターの現在の構成と互換性があり、したがって印刷できるかどうかを判断します。

構文

BOOL DevQueryPrintEx(
  [in, out] PDEVQUERYPRINT_INFO pDQPInfo
);

パラメーター

[in, out] pDQPInfo

呼び出し元が指定した DEVQUERYPRINT_INFO 構造体へのポインター。

戻り値

印刷ジョブを印刷できる場合、関数は TRUE 返す必要があります。それ以外の場合は、FALSE 返す必要があります。

備考

プリンター インターフェイス DLL は、DevQueryPrintEx 関数 定義する必要があります。 プリンターのプロパティ シートの [詳細設定] ページで [の不一致ドキュメントの保持] オプションをオンにすると、印刷スプーラーによってこの関数が呼び出されます。 関数が TRUE 返した場合、スプーラーは印刷ジョブをキューに入れます。 それ以外の場合は、プリンターが最終的に再構成され、ジョブが印刷可能になると想定して、ジョブが保持されます。

受け取った DEVQUERYPRINT_INFO 構造体は、印刷ジョブに必要なプリンター特性を記述する DEVMODEW 構造体を指しています。 DevQueryPrintEx 関数は、まず、受信した DEVMODEW 構造体のサイズとバージョンのメンバーがドライバーと互換性があることを確認する必要があります。 次に、指定された DEVMODEW コンテンツが現在のプリンター構成と互換性があるかどうかを判断する必要があります。

ジョブを出力できる場合、関数は TRUE 返す必要があります。 ジョブを後で保持する必要がある場合、関数は、表示可能なテキスト文字列 (DEVQUERYPRINT_INFO構造体 の pszErrorStr メンバーが指すバッファー内) を指定した後、ジョブを出力できない理由を示す FALSE を返す必要があります。

表示可能なテキスト文字列は、リソース ファイル内の文字列リソースとして定義する必要があります。

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	winddiui.h (Winddiui.h を含む)
ライブラリ	Winspool.lib
DLL	WinSpool.drv