DrvSplDeviceCaps 関数 (winddiui.h)

プリンター インターフェイス DLL の DrvSplDeviceCaps 関数は、プリンターの機能を照会します。

構文

DWORD DrvSplDeviceCaps(
                  HANDLE   hPrinter,
  [in]            PWSTR    pszDeviceName,
                  WORD     Capability,
  [out, optional] PVOID    pOutput,
                  DWORD    cchBufSize,
  [in, optional]  PDEVMODE pDevmode
);

パラメーター

hPrinter

プリンターへの呼び出し元指定ハンドル。

[in] pszDeviceName

プリンター名を含む Unicode 文字列への呼び出し元指定ポインター。

Capability

クエリを実行する機能を示す呼び出し元指定のビット フラグ。 (フラグはヘッダー ファイル wingdi.h で定義されています)。この関数は、すべてのDC_XXX フラグをサポートする必要はありませんが、次の表に示すフラグをサポートする必要があります。

フラグ	定義
DC_MEDIAREADY	pOutput パラメーターは、関数が文字列バッファーの配列 (各 64 文字の長さ) で埋めるバッファーを指します。 各配列要素には、使用できる用紙フォームの名前を表す NULL で終わる文字列が含まれている必要があります。 関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput が NULL の場合、関数は必要な配列要素の数だけを返す必要があります。
DC_PAPERNAMES	pOutput パラメーターは、関数が文字列バッファーの配列 (各 64 文字の長さ) で埋めるバッファーを指します。 各配列要素には、用紙フォームの名前を表す NULL で終わる文字列が含まれている必要があります。 関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput が NULL の場合、関数は必要な配列要素の数だけを返す必要があります。

[out, optional] pOutput

関数指定の情報を受け取るバッファーへの呼び出し元提供ポインター。 バッファーの使用は 、Capability パラメーターの値によって異なります。 呼び出し元は、このバッファーの割り当てと解放を担当します。

cchBufSize

pOutput パラメーターが指すバッファーの呼び出し元指定サイズ (文字数)。

[in, optional] pDevmode

現在の印刷ジョブ特性を記述する DEVMODEW 構造体への呼び出し元指定ポインター。 NULL の場合、関数はドライバーの内部の既定の DEVMODEW 構造体を使用する必要があります。

戻り値

戻り値は Capability パラメーターによって異なります。 Capability がドライバーでサポートされていない機能を示している場合、またはエラーが発生した場合、関数は GDI_ERRORを返す必要があります。

注釈

DC_XXX フラグの説明については、「 DrvDeviceCapabilities」を参照してください。

スプーラーは序数 254 を使用してドライバー関数ポインターを取得するため、この関数は .def ファイルで DrvSplDeviceCaps @ 254 として定義する必要があります。

要件

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

こちらもご覧ください

DrvDeviceCapabilities