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