静止画像デバイスの INF ファイル
静止画像デバイス の既定のクラス インストーラーである sti_ci.dll は、特別な INF ファイル エントリのセットを認識します。 INF ファイル内では、これらのエントリはデバイスの INF DDInstall セクション内に配置する必要があります。 各エントリーについては次の表で説明します。
| INF ファイル エントリ | Value | Comments |
|---|---|---|
| サブクラス | StillImage | 必須 |
| DeviceType | スキャナーの場合は 1、カメラの場合は 2、ビデオ デバイスの場合は 3 | 必須 |
| DeviceSubType | ベンダー定義値 | 省略可能 |
| つながり | シリアル ポートまたは並列ポートに接続されている非 PnP デバイスの場合、インストール時にユーザーが選択するポートを制限するに当たり、シリアルまたは並列にできます。 | 省略可能。 指定しない場合、ユーザーは任意でシリアルまたは並列ポートを選択できます。 |
| 機能 | デバイスの機能を識別するビット フラグに変換される数値を指定します。 これらのフラグはレジストリに格納され、STI_DEV_CAPS 構造の Microsoft STI コンポーネントで使用できます。 ビット 0 - STI_DEV_CAPSのSTI_GENCAP_NOTIFICATIONS を設定/クリア ビット 1 - STI_DEV_CAPSで STI_GENCAP_POLLING_NEEDED を設定/クリア ビット 2 - STI_DEV_CAPSのSTI_GENCAP_GENERATE_ARRIVALEVENT を設定/クリア ビット 3 - STI_DEV_CAPSで STI_GENCAP_AUTO_PORTSELECT を設定/クリア |
省略可能 |
| PropertyPages | カスタマイズされた静止画像デバイス用プロパティ シート ページを作成する DLL の名前とエントリ ポイントを識別します。 次の例では、この DLL である estp2cpl.dll、およびこの DLL のEnumStiPropPages エントリ ポイントを識別します。 エントリ ポイント名は省略可能です。省略すると、エントリ ポイントは既定で EnumStiPropPages になります。 PropertyPages = estp2cpl.dll, EnumStiPropPages |
省略可能 |
| DeviceData | DeviceData キーの下のレジストリに格納する情報を含む、ベンダーが指定したデータ セクションを識別します。 TWAIN 対応のデバイスの場合、データ セクションには TwainDS エントリが含まれている必要があります。 詳細は、「ベンダー変更可能なレジストリ値」を参照してください。 | 省略可能。 ただし、このエントリは、プッシュ モデル対応アプリケーションを作成するために必要です。 |
| Events | 静止画像デバイス イベントを一覧表示し、ベンダーが提供するデータ セクションを識別します。 このセクションの各エントリは、次の形式にしてください。EventName="String",{GUID},AppEventName はイベントの内部名、String はイベントの表示文字列、GUID はイベントの GUID (静止画像デバイス イベントを参照)、Appはイベントが発生したときに起動されるイメージング アプリケーションを指定します。 現在登録されているアプリケーションを起動するには、App にアスタリスク (*) を使用します。 |
省略可能。 ただし、このエントリは、プッシュ モデル対応アプリケーションを作成するために必要です。 |
| UninstallSection | 通常、INF DelFiles ディレクティブと INF DelReg ディレクティブを含む INF セクションを指します。 このセクションのエントリの形式は、次のとおりです。UninstallSection=UninstallSectionNameUninstallSectionName は、Delfiles ディレクティブまたは DelReg ディレクティブを含むセクションの名前です。 Windows ファイル保護では、ユーザーが DelFiles ディレクティブを使用して指定されている場合でも、一部のファイルの削除が禁止される場合があります。 |
省略可能。 このエントリは、Windows 2000 でのみ有効です。 |
静止画像デバイスの既定のクラス インストーラーは、標準の INF CopyFiles ディレクティブ に対応しています。 インストーラーはコンポーネント ファイルに内部参照カウンターを使用するため、アンインストール操作中に複数のデバイスで共有されているファイルが途中で削除されることはありません。
静止画像デバイスの既定の INF ファイルである sti.inf では、次のようにデバイスの種類ごとに 2 つのインストール セクションが定義されています。
次の表に示すように、ベンダーが提供する INF ファイルの DDInstall セクション内で参照する必要がある INF DDInstall Section。
USB デバイス SCSI デバイス シリアル デバイス Include=sti.infNeeds=STI.USBSectionInclude=sti.infNeeds=STI.SCSISectionInclude=sti.infNeeds=STI.SerialSection次の表に示すように、ベンダーが提供する INF ファイルの DDInstall セクション内で参照する必要がある INF DDInstall Section。
USB デバイス SCSI デバイス シリアル デバイス Include=sti.infNeeds=STI.USBSection.ServicesInclude=sti.infNeeds=STI.SCSISection.ServicesInclude=sti.infNeeds=STI.SerialSection.Services
イメージ取得 API 用のデバイス固有のコンポーネントも作成する場合、通常はこれらのコンポーネントのファイル名を INF ファイルに含めてください。
静止画像デバイス用の INF ファイルの作成に関する追加のガイダンスは、"Subclass=StillImage" とのエントリを含む Windows で提供される INF ファイルを確認できます。
解説
スキャナー用の INF ファイルを開発する場合、Microsoft OS 記述子を使用し互換性 ID 機能を有効にできます。 これを行うと、1 つのスキャナー ドライバーが複数のスキャナー モデルと互換性を持つことができるようになります。