INF-Dateien für Standbildgeräte
Das Standardklasseninstallationsprogramm für Standbildgeräte ,sti_ci.dll, erkennt einen speziellen Satz von INF-Dateieinträgen. Innerhalb einer INF-Datei müssen diese Einträge im INF-DDInstall-Abschnitt eines Geräts platziert werden. Die Einträge werden in der folgenden Tabelle beschrieben.
| INF-Dateieintrag | Wert | Kommentare |
|---|---|---|
| SubClass | StillImage | Erforderlich |
| DeviceType | 1 für Scanner, 2 für Kameras, 3 für Videogeräte | Erforderlich |
| DeviceSubType | Vom Hersteller definierte Werte | Optional |
| Verbindung | Bei Nicht-PnP-Geräten, die mit seriellen oder parallelen Ports verbunden sind, kann dies serielle oder parallele Geräte sein, um die Auswahl der Ports während der Installation einzuschränken. | Optional. Wenn nicht angegeben, kann der Benutzer einen beliebigen seriellen oder parallelen Port auswählen. |
| Funktionen | Gibt eine Zahl an, die in Bitflags konvertiert wird, die Gerätefunktionen identifizieren. Diese Flags werden in der Registrierung gespeichert und sind für Microsoft STI-Komponenten mit der STI_DEV_CAPS-Struktur verfügbar. Bit 0 − Legt STI_GENCAP_NOTIFICATIONS in STI_DEV_CAPS fest/löscht Bit 1 − Setzt/löscht STI_GENCAP_POLLING_NEEDED in STI_DEV_CAPS Bit 2 − Legt STI_GENCAP_GENERATE_ARRIVALEVENT in STI_DEV_CAPS fest/löscht Bit 3 − Legt STI_GENCAP_AUTO_PORTSELECT in STI_DEV_CAPS fest/löscht STI_DEV_CAPS |
Optional |
| PropertyPages | Gibt den Namen und Einstiegspunkt einer DLL an, die benutzerdefinierte Eigenschaftenblattseiten für Standbildgeräte erstellt. Im folgenden Beispiel werden die DLL, estp2cpl.dllund der Einstiegspunkt EnumStiPropPages in dieser DLL identifiziert. Der Name des Einstiegspunkts ist optional. wenn nicht angegeben, lautet der Einstiegspunkt standardmäßig EnumStiPropPages. PropertyPages = estp2cpl.dll, EnumStiPropPages |
Optional |
| DeviceData | Identifiziert einen vom Anbieter bereitgestellten Datenabschnitt, der Informationen enthält, die in der Registrierung unter dem DeviceData-Schlüssel gespeichert werden sollen. Für TWAIN-unterstützte Geräte muss der Datenabschnitt einen TwainDS-Eintrag enthalten. Weitere Informationen finden Sie unter Anbieter änderbare Registrierungswerte. | Optional. Dieser Eintrag ist jedoch erforderlich, um Push-Model aware Applications zu erstellen. |
| Ereignisse | Identifiziert einen vom Anbieter bereitgestellten Datenabschnitt, in dem Standbildgeräteereignisse aufgelistet sind. Jeder Eintrag in diesem Abschnitt muss das folgende Format aufweisen:EventName="String",{GUID},AppEventName ist der interne Name des Ereignisses, String ist die Anzeigezeichenfolge des Ereignisses, GUID ist die GUID des Ereignisses, siehe Standbildgeräteereignisse, und App gibt die Imaginganwendung an, die gestartet werden soll, wenn das Ereignis auftritt. Verwenden Sie zum Starten der aktuell registrierten Anwendung ein Sternchen (*) für Die App. |
Optional. Dieser Eintrag ist jedoch erforderlich, um Push-Model aware Applications zu erstellen. |
| UninstallSection | Verweist auf einen INF-Abschnitt, der in der Regel INF DelFiles-Direktiven und INF DelReg-Anweisungen enthält. Ein Eintrag in diesem Abschnitt hat das folgende Format:UninstallSection=UninstallSectionNameUninstallSectionName ist der Name des Abschnitts, der delfiles - oder DelReg-Anweisungen enthält. Windows-Dateischutz kann einem Benutzer das Löschen einiger Dateien verbieten, obwohl sie mithilfe von DelFiles-Anweisungen angegeben werden. |
Optional. Dieser Eintrag ist nur für Windows 2000 gültig. |
Das Standardklasseninstallationsprogramm für Standbildgeräte unterstützt die Standardmäßige INF CopyFiles-Direktive. Das Installationsprogramm verwendet einen internen Verweiszähler für Komponentendateien, sodass Dateien, die von mehreren Geräten freigegeben werden, während eines Deinstallationsvorgangs nicht vorzeitig entfernt werden.
Die Standard-INF-Datei für Standbildgeräte, sti.inf, definiert zwei Installationsabschnitte für jeden Gerätetyp wie folgt:
Ein INF-DDInstall-Abschnitt, auf den im Abschnitt DDInstall der vom Anbieter bereitgestellten INF-Datei verwiesen werden muss, wie in der folgenden Tabelle gezeigt.
USB-Geräte SCSI-Geräte Serielle Geräte Include=sti.infNeeds=STI.USBSectionInclude=sti.infNeeds=STI.SCSISectionInclude=sti.infNeeds=STI.SerialSectionEin INF DDInstall.Services-Abschnitt, auf den im DDInstall verwiesen werden muss. Der Abschnitt Dienste der vom Anbieter bereitgestellten INF-Datei, wie in der folgenden Tabelle dargestellt.
USB-Geräte SCSI-Geräte Serielle Geräte Include=sti.infNeeds=STI.USBSection.ServicesInclude=sti.infNeeds=STI.SCSISection.ServicesInclude=sti.infNeeds=STI.SerialSection.Services
Wenn Sie auch gerätespezifische Komponenten für Bilderfassungs-APIs erstellen, fügen Sie in der Regel die Dateinamen für diese Komponenten in die INF-Datei ein.
Weitere Anleitungen zum Erstellen von INF-Dateien für Standbildgeräte finden Sie in jeder in Windows bereitgestellten INF-Datei, die den Eintrag "Subclass=StillImage" enthält.
Hinweise
Wenn Sie eine INF-Datei für Scanner entwickeln, können Sie Microsoft-Betriebssystemdeskriptoren verwenden, um die Kompatibilitäts-ID-Funktionalität zu aktivieren. In diesem Fall lassen Sie zu, dass ein Scannertreiber mit mehreren Scannermodellen kompatibel ist.