ルート レベルのみの属性
重要
Windows でプリンターとの通信手段として推奨されるのは、最新の印刷プラットフォームです。 プリンターデバイス開発におけるWindows 10および11での印刷体験をカスタマイズするために、MicrosoftのIPPインボックスクラスドライバーとPrint Support Apps (PSA)の使用を推奨します。
詳細については、最新の印刷プラットフォームに関する記事および「印刷サポート アプリの設計ガイド」を参照してください 。
ルート レベルのみの属性は、リソース ファイル、ヘルプ ファイル、および追加の GPD ファイルの名前、ドライバーのマスター ユニット、バージョン番号、および文字コード ページの仕様など、ドライバー固有の特性を記述する一般的な属性です。
追加のルート レベルのみの属性では、プリンターの名前、種類、最大コピー容量、フォント カートリッジ スロットの数など、デバイス固有の特性を指定します。
これらの属性は、GPD ファイルの (中かっこ内ではなく) ルート レベルに常に配置する必要があるため、ルート レベルのみの属性と呼ばれます。
次の表に、ルート レベルのみの属性を示します。
| Attribute name | AttributeParameter | Comments |
|---|---|---|
| CodePage | 数値の Windows コード ページ識別子。 | 省略可能。 指定しない場合は、Unicode が使用されます。 コード ページは、表示されているすべての文字列に適用されます。 |
| FontCartSlots | プリンターによって提供されるフォント カートリッジ スロットの数を表す数値。 | 省略可能。 指定しない場合、既定値はゼロになります。 |
| GPDFileName | GPD ファイル名を表す引用符で囲まれたテキスト文字列 (パスなし)。 | 省略可能。 |
| GPDFileVersion | 現在の GPD ファイル バージョンを表す引用符で囲まれたテキスト文字列。 推奨される形式は MajorVersion.MinorVersion ("1.0" など) です。 | 省略可能。 指定した場合、この文字列は Unidrv の [バージョン情報] ダイアログ ボックスに表示されます。 |
| GPDSpecVersion | 現在の GPD 仕様バージョンを表す引用符で囲まれたテキスト文字列。 必要な形式は MajorVersion.MinorVersion ("1.0" など) です。 | 必須。 GPD ファイルの最初のエントリとして、コメントの前に指定する必要があります。Windows 2000 の場合、この値は "1.0" にする必要があります。 |
| HelpFile | カスタマイズされたヘルプ ファイルの名前を含む引用符で囲まれた文字列。拡張子は .hlp です。 | 省略可能。 含まれている場合、Unidrv のヘルプ ファイルにトピックを追加したり、既存のトピックを上書きすることができます。 ヘルプ ファイルのインデックスは、機能とオプションの *HelpIndex 属性で指定されます。 |
| 含む | 追加の GPD ファイルの名前を含む引用符で囲まれた文字列。 | 互換性のために残されています。 このエントリはプリプロセッサ ディレクティブとして再定義されました。 |
| InstalledOptionName | インストール可能な機能またはオプションがインストールされていることを示すために表示される引用符で囲まれた文字列。 通常、この文字列は "Installed" ですが、任意の適切な文字列を指定できます。 | いずれかの機能またはオプションの *Installable? が TRUE の場合 (「機能属性」を参照)、および rcInstalledOptionNameID が指定されていない場合は必須です。 |
| MasterUnits | プリンターのマスター ユニットを表す PAIR。 | 必須。 丸めエラーの可能性を減らすには、フォント メトリック データの解像度単位に MasterUnits に指定したものと同じ値を使用します。 (「カスタマイズしたフォント管理」の「Unidrv フォント メトリック」を参照してください)。 |
| MaxCopies | プリンターがサポートできるコピーの最大数を表す数値。 | 省略可能。 指定しない場合は、既定値は 1 です。 |
| ModelName | プリンター モデル名を表す引用符で囲まれたテキスト文字列。 | rcModelNameID が指定されていない場合は必須です。 文字列は setup.inf 内の名前と一致する必要があります。 |
| NotInstalledOptionName | インストール可能な機能またはオプションがインストールされていないことを示すために表示される引用符で囲まれた文字列。 通常、この文字列は "Not installe" ですが、任意の適切な文字列を指定できます。 | いずれかの機能またはオプションの Installable? が TRUE の場合 (「機能属性」を参照)、および rcNotInstalledOptionNameID が指定されていない場合は必須です。 |
| パーソナリティ | プリンターで使用されるプリンター言語を表す引用符で囲まれた文字列。 | 省略可能。 指定した場合、ディレクトリ サービスによって文字列が表示されます。 この表内にある下の「rcPersonalityID」も参照してください。 |
| PrinterType | PAGE、SERIAL、または TTY | 必須 |
| PrintRate | モノクロ印刷速度を表す数値。 単位は PrintRateUnit で指定されます。 | 省略可能。 指定しない場合は、既定値は 0 です。 |
| PrintRatePPM | 印刷速度を表す数値 (1 分あたりのページ数)。 | 省略可能。 指定しない場合は、既定値は 0 です。 |
| PrintRateUnit | PPM - ページ/分 CPS - 文字/秒 LPM - 行/分 IPM - インチ/分 (IPM はプロッター用) |
PrintRate を指定した場合は必須。 指定した単位がプリンターの種類と一致している必要があります。 たとえば、ページ プリンターには PPM を指定する必要があります。 |
| rcInstalledOptionNameID | インストール可能な機能またはオプションがインストールされていることを示すために表示される文字列リソースのリソース ID。 通常、この文字列は "Installed" ですが、任意の適切な文字列を指定できます。 | いずれかの機能またはオプションの Installable? が TRUE の場合 (「機能属性」を参照)、および InstalledOptionName が指定されていない場合は必須です。 |
| rcNotInstalledOptionNameID | インストール可能な機能またはオプションがインストールされていないことを示すために表示される文字列リソースのリソース ID。 通常、この文字列は "Not installe" ですが、任意の適切な文字列を指定できます。 | いずれかの機能またはオプションの Installable? が TRUE の場合 (「機能属性」を参照)、および NotInstalledOptionName が指定されていない場合は必須です。 |
| rcPersonalityID | プリンターで使用されるプリンター言語を表す文字列リソースのリソース ID。 | 省略可能。 指定した場合、ディレクトリ サービスによって文字列が表示されます。 「Personality」も参照してください。 |
| rcPrinterIconID | プリンターに関連付けられているアイコンを表す RC_ICON リソースのリソース ID。 | 省略可能。 指定しない場合は、既定のプリンター アイコンが表示されます。 すべての RC_ICON リソース ID は、1 から始まる連番を付けることをお勧めします。 |
| ResourceDLL | リソース DLL のパス情報のない名前を含む引用符で囲まれた文字列。 | 省略可能。 「ミニドライバーでのリソース DLL の使用」を参照してください。 |
Windows Vista の新しいルート レベルのみの属性については、「Windows Vista の新しいルート レベルのみの GPD 属性」および「Windows Vista の新しいルート レベルのみの PPD 属性」を参照してください。