DrvDeviceCapabilities 関数 (winddiui.h)

[アーティクル]
02/07/2025

プリンターインターフェイス DLL の DrvDeviceCapabilities 関数は、プリンターの機能に関する要求された情報を返します。

構文

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

パラメーター

hPrinter

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

[in] pszDeviceName

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

Capability

要求されている情報を示す呼び出し元指定のビットフラグ。これは、次の表に示すフラグのいずれかになります。 (フラグはヘッダーファイル Wingdi.h で定義されています)。

旗	定義
DC_BINADJUST	NT ベースのオペレーティングシステムには使用されません。
DC_BINNAMES	pOutput パラメーターは、関数が文字列バッファーの配列 (各 24 文字の長さ) で埋めるバッファーを指します。配列内の各文字列バッファーには、用紙ソースビンの名前を指定するワイド文字の NULL で終わる文字列が含まれている必要があります。関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput が NULL 場合、関数は必要な配列要素の数だけを返す必要があります。
DC_BINS	pOutput パラメーターは、関数が WORD 配列で埋めるバッファーを指します。各配列要素には、サポートされている用紙ソースビンを表す DMBIN プレフィックス付き定数 (またはカスタマイズされた値) が含まれている必要があります。関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput が NULL 場合、関数は必要な配列要素の数だけを返す必要があります。
DC_COLLATE	pOutput パラメーターは使用されません。プリンターが照合をサポートしている場合、関数の戻り値は 1 にする必要があります。それ以外の場合、戻り値は 0 にする必要があります。
DC_COLORDEVICE	pOutput パラメーターは使用されません。プリンターがカラー印刷をサポートしている場合、関数の戻り値は 1 にする必要があります。それ以外の場合、戻り値は 0 にする必要があります。
DC_COPIES	pOutput パラメーターは使用されません。関数の戻り値は、プリンターがサポートできるコピーの最大数である必要があります。
DC_DATATYPE_PRODUCED	NT ベースのオペレーティングシステムには使用されません。
DC_DRIVER	pOutput パラメーターは使用されません。関数の戻り値は、ドライバーの内部 [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew) 構造体の dmDriverVersion メンバーである必要があります。
DC_DUPLEX	pOutput パラメーターは使用されません。プリンターが両面印刷をサポートしている場合、関数の戻り値は 1 にする必要があります。それ以外の場合、戻り値は 0 にする必要があります。
DC_EMF_COMPLIANT	NT ベースのオペレーティングシステムには使用されません。
DC_ENUMRESOLUTIONS	pOutput パラメーターは、関数が LONG 配列で埋めるバッファーを指します。プリンターでサポートされる解像度ごとに、この関数は解像度の 2 つの長い単語 (x ディメンション用と y 次元用) をドット/インチで返す必要があります。関数の戻り値は、サポートされている解像度の数である必要があります。 pOutput NULL 場合、関数はサポートされている解像度の数を返すだけです。
DC_EXTRA	pOutput パラメーターは使用されません。関数の戻り値は、ドライバーの内部 [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew) 構造体の dmDriverExtra メンバーである必要があります。
DC_FIELDS	pOutput パラメーターは使用されません。関数の戻り値は、ドライバーの内部 [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew) 構造体の dmFields メンバーである必要があります。 dmFields メンバーは、DEVMODEW 構造体のデバイスに依存しない部分のどのメンバーがプリンタードライバーでサポートされているかを示します。
DC_FILEDEPENDENCIES	pOutput パラメーターは、関数が文字列バッファーの配列 (各 64 文字の長さ) で埋めるバッファーを指します。配列内の各文字列バッファーには、ドライバーと共にインストールする必要があるファイルの名前を指定するワイド文字の NULL で終わる文字列が含まれている必要があります。関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput が NULL 場合、関数は必要な配列要素の数だけを返す必要があります。
DC_MANUFACTURER	NT ベースのオペレーティングシステムには使用されません。
DC_MAXEXTENT	pOutput パラメーターは使用されません。この関数は POINTS 構造体を返す必要があります (Microsoft Windows SDK のドキュメントで説明)。構造体には、プリンターの DEVMODEW 構造体の dmPaperWidth (x 次元) および dmPaperLength (y ディメンション) メンバーの最大許容値が含まれている必要があります。
DC_MEDIAREADY	pOutput パラメーターは、関数が文字列バッファーの配列 (各 64 文字の長さ) で埋めるバッファーを指します。配列内の各文字列バッファーには、使用できる用紙フォームの名前を指定するワイド文字の NULL で終わる文字列が含まれている必要があります。関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput が NULL 場合、関数は必要な配列要素の数だけを返す必要があります。
DC_MEDIATYPENAMES	pOutput パラメーターは、関数が文字列バッファーの配列 (各 64 文字の長さ) で埋めるバッファーを指します。配列内の各文字列バッファーには、サポートされているメディアの種類の名前を指定するワイド文字の NULL で終わる文字列が含まれている必要があります。関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput NULL 場合、関数は必要な配列要素の数を返すだけです。
DC_MEDIATYPES	pOutput パラメーターは、関数が DWORD 配列で埋めるバッファーを指します。各配列要素には、DMMEDIA プレフィックス付き定数 ([DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew を参照) またはサポートされているメディアの種類を表すカスタマイズされた値を含める必要があります。関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput NULL 場合、関数は必要な配列要素の数を返すだけです。
DC_MINEXTENT	pOutput パラメーターは使用されません。この関数は POINTS 構造体を返す必要があります (Windows SDK のドキュメントで説明されています)。構造体には、プリンターの DEVMODEW 構造体の dmPaperWidth (x ディメンション) および dmPaperLength (y ディメンション) メンバーの最小値を含める必要があります。
DC_MODEL	NT ベースのオペレーティングシステムには使用されません。
DC_NUP	pOutput パラメーターは、関数が DWORD 配列で埋めるバッファーを指します。各配列要素には、N アップオプションを表す整数を含める必要があります (つまり、各整数は、物理ページごとにサポートされるドキュメントページ数を表す必要があります)。関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput が NULL 場合、関数は必要な配列要素の数だけを返す必要があります。
DC_ORIENTATION	pOutput パラメーターは使用されません。関数の戻り値は、縦向きから横方向の向きを生成するために必要な回転角度の数である必要があります。値 0 は、横向きがサポートされていないことを示します。
DC_PAPERNAMES	pOutput パラメーターは、関数が文字列バッファーの配列 (各 64 文字の長さ) で埋めるバッファーを指します。配列内の各文字列バッファーには、用紙フォームの名前を指定するワイド文字の NULL で終わる文字列が含まれている必要があります。関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput が NULL 場合、関数は必要な配列要素の数だけを返す必要があります。
DC_PAPERS	pOutput パラメーターは、関数が WORD 配列で埋めるバッファーを指します。各配列要素には、サポートされている用紙形式を表す DMPAPER プレフィックス付き定数 (またはカスタマイズされた値) が含まれている必要があります。関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput が NULL 場合、関数は必要な配列要素の数だけを返す必要があります。
DC_PAPERSIZE	pOutput パラメーターは、関数が POINT 配列で埋めるバッファーを指します。各配列要素には、フォームの用紙サイズの x と y の寸法を縦向きに 0.1 mm 単位で含める必要があります。関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput が NULL 場合、関数は必要な配列要素の数だけを返す必要があります。
DC_PERSONALITY	pOutput パラメーターは、関数が文字列バッファーの配列 (各 32 文字の長さ) で埋めるバッファーを指します。配列内の各文字列バッファーには、プリンターでサポートされているプリンター記述言語 (L"HP-GL/2" など) を指定するワイド文字の NULL で終わる文字列が含まれている必要があります。関数の戻り値は、返される配列内の要素の数である必要があります。 pOutput が NULL 場合、関数は必要な配列要素の数だけを返す必要があります。
DC_PRINTERMEM	pOutput パラメーターは使用されません。関数の戻り値は、使用可能なプリンターメモリの量 (KB 単位) を表す整数である必要があります。
DC_PRINTRATE	pOutput パラメーターは使用されません。関数の戻り値は、DC_PRINTRATEUNITに指定された単位で、印刷速度を表す整数である必要があります。
DC_PRINTRATEPPM	pOutput パラメーターは使用されません。関数の戻り値は、印刷速度を表す整数 (1 分あたりのページ数) である必要があります。
DC_PRINTRATEUNIT	pOutput パラメーターは使用されません。関数の戻り値は、DC_PRINTRATEに返される値を指定するために使用される単位を識別する必要があります。次のいずれかの定数を指定する必要があります: PRINTRATEUNIT_PPM - pages/min。 PRINTRATEUNIT_CPS - chars./sec. PRINTRATEUNIT_LPM - 行/分。 PRINTRATEUNIT_IPM - インチ/分。
DC_SIZE	pOutput パラメーターは使用されません。関数の戻り値は、ドライバーの内部 [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew) 構造体の dmSize メンバーである必要があります。
DC_STAPLE	pOutput パラメーターは使用されません。プリンターがステープルをサポートしている場合は関数の戻り値を TRUE し、プリンターがステープルをサポートしていない場合は FALSE をする必要があります。
DC_TRUETYPE	pOutput パラメーターは使用されません。関数の戻り値には、0、1、または複数のフラグを指定できます。DCTT_BITMAP: デバイスは TrueType フォントをグラフィックスとして印刷できます。 DCTT_DOWNLOAD: デバイスは、ダウンロードした TrueType フォントを受け入れます。 DCTT_DOWNLOAD_OUTLINE: (Windows 95/98/Me のみ) デバイスはアウトライン TrueType フォントをダウンロードできます。 DCTT_SUBDEV: デバイスは、デバイスフォントを TrueType フォントに置き換えることができます。
DC_VERSION	pOutput パラメーターは使用されません。関数の戻り値は、ドライバーの内部 [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew) 構造体の dmSpecVersion メンバーである必要があります。

[out] pOutput

関数指定の情報を受信するためのバッファーへの呼び出し元指定のポインター。バッファーの使用は、Capability パラメーターに対して受け取った値によって異なります。

[in, optional] pDevmode

現在の印刷ジョブの特性を記述する、DEVMODEW 構造体への呼び出し元指定のポインター。このパラメーターが NULL 場合、DrvDeviceCapabilities は、印刷キューのユーザーの既定の DEVMODEW 構造体など、指定されたプリンタードライバーの現在の既定の初期化値を取得します。

戻り値

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

必要条件

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

次の方法で共有

DrvDeviceCapabilities 関数 (winddiui.h)

構文

パラメーター

戻り値

必要条件

フィードバック

その他のリソース