Freigeben über

INF-Dateien für WIA-Geräte

Von Bedeutung

Einige der in diesem Artikel enthaltenen Informationen beziehen sich auf veraltete Windows-Betriebssysteme.

Das Standardklasseninstallationsprogramm für stille Bildgerä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
Unterklasse StillImage Erforderlich
DeviceType 1 für Scanner

2 für Kameras

3 zum Streamen von Video		 Erforderlich
GerätUntertyp Anbieterdefinierter Wert Wahlfrei
Verbindung Bei Nicht-Plug- und Play-Geräten, die mit seriellen oder parallelen Ports verbunden sind, kann dies serial oder parallel sein, um die Auswahl der Ports des Benutzers während der Installation zu begrenzen. Wahlfrei

Wenn nicht angegeben, kann der Benutzer einen beliebigen seriellen oder parallelen Port auswählen.
Funktionen Gibt eine Zahl an, die in Bitkennzeichnungen konvertiert wird, die Gerätefunktionen identifizieren. Diese Flags werden in der Registrierung gespeichert und sind für STI-Komponenten mit der STI_DEV_CAPS Struktur verfügbar.

Bit 0 − Legt STI_GENCAP_NOTIFICATIONS in STI_DEV_CAPS fest/löscht sie.

Bit 1 − Legt STI_GENCAP_POLLING_NEEDED in STI_DEV_CAPS fest/löscht sie.

Bit 2 − Legt STI_GENCAP_GENERATE_ARRIVALEVENT in STI_DEV_CAPS fest oder löscht es.

Bit 3 − Legt STI_GENCAP_AUTO_PORTSELECT in STI_DEV_CAPS fest oder löscht es.

Bit 4 − Legt STI_GENCAP_WIA in STI_DEV_CAPS fest/löscht sie.

Bit 5 − Setzt/löscht STI_GENCAP_SUBSET in STI_DEV_CAPS.		 Wahlfrei

Bit 5 wird derzeit nicht verwendet.

Legen Sie diesen Eintrag in Ihrer INF-Datei auf 0x33 fest, um Push-Button-Ereignisse mit Ihrem Scanner zu unterstützen.
PropertyPages Nur für Windows 98 und Windows 2000

Identifiziert den Namen und Einstiegspunkt einer DLL, die angepasste Eigenschaftsblätter für Standbildgeräte erstellt.

Weitere Informationen zum PropertyPages-Eintrag finden Sie unter INF-Dateien für Still Image Devices.		 Wahlfrei

Dieser Eintrag dient nur für STI-Treiber und ist für WIA-Treiber veraltet.

Informationen zu Eigenschaftenseiten, die für WIA-Treiberentwickler relevant sind, finden Sie in der Notiz zu PropertyPages, die dieser Tabelle folgen.
DeviceData- Identifiziert einen vom Anbieter bereitgestellten Datenabschnitt, der Informationen enthält, die in der Registrierung gespeichert werden sollen, unter dem DeviceData-Schlüssel . Für TWAIN-unterstützte Geräte muss der Datenabschnitt einen TwainDS-Eintrag enthalten (siehe Registrierungseinträge für WIA-Treiber) Wahlfrei
Ereignisse Identifiziert einen vom Anbieter bereitgestellten Datenabschnitt, der Standbildgeräteereignisse auflistet. Jeder Eintrag in diesem Abschnitt muss das folgende Format aufweisen:

EventName="String",{GUID},App

EventName ist der interne Name des Ereignisses, Zeichenfolge ist die Anzeigezeichenfolge des Ereignisses, GUID ist die GUID des Ereignisses, und Die App gibt die Imageerstellungsanwendung an, die gestartet werden soll, wenn das Ereignis eintritt. Verwenden Sie zum Starten der aktuell registrierten Anwendung ein Sternchen () fürApp*.		 Erforderlich
PortSelect Wenn für die Geräteinstallation keine Portauswahlseite erforderlich ist, führt der Wert "nein" dazu, dass diese Seite übersprungen wird. Dieser Wert bewirkt auch, dass der CreateFileName-Eintragswert (siehe Hinweis für CreateFileName und PortSelect nach dieser Tabelle) automatisch auf AUTO festgelegt wird.

Ein Wert von Message1 bewirkt, dass eine vom System bereitgestellte Nachricht angezeigt wird, und legt den CreateFileName-Eintragswert auf AUTO fest.

Gilt für Scanner und Kameras, die eine manuelle Installation erfordern.		 Wahlfrei

Für Plug- und Play-Geräte wird PortSelect ignoriert, das Gerät muss jedoch trotzdem den Wert für den CreateFileName-Eintrag auf AUTO festgelegt haben, damit WIA das Gerät laden kann. Verwenden Sie die INF-AddReg-Direktive , um diesen Eintrag zum ABSCHNITT INF DDInstall der INF-Datei des Geräts hinzuzufügen.

Hinweis

Um mit einem Gerät zu kommunizieren, muss ein Benutzermodusclient (ein Minidriver) den WIA-Dienst nach dem Dateinamen des Geräts und einer Zeichenfolge fragen, die den Namen des zu erstellenden oder geöffneten Objekts angibt. (Der Dateiname muss nicht der Name einer Datenträgerdatei sein.) Als Reaktion auf eine solche Abfrage ruft der WIA-Dienst den Dateinamen des Geräts aus dem Registrierungseintrag CreateFileName ab. (Die treiber für denusbscan.sys und scsiscan.sys Kernelmodus erstellen diesen Eintrag wie das Klasseninstallationsprogramm.) Der Minidriver empfängt diesen Dateinamen durch Aufrufen der IStiDeviceControl::GetMyDevicePortName-Methode . Der Minidriver kann diesen Dateinamen dann verwenden, wenn er die CreateFile-Funktion aufruft, um ein Handle für das Gerät zu öffnen. Wenn das Gerät manuell installiert wird, erstellt das Klasseninstallationsprogramm den CreateFileName-Eintrag und legt dessen Wert auf einen fest, der von der Auswahl des Benutzers auf der Portauswahlseite abhängt: COMX, LPTX oder AUTO. Für einige Geräte (z. B. Netzwerkscanner), die manuell installiert werden, ist kein Port erforderlich. In solchen Fällen kann das resultierende Dialogfeld für die Portauswahl Benutzer verwirren. Sie können verhindern, dass dieses Dialogfeld angezeigt wird, indem Sie den folgenden Eintrag im INF DDInstall-Abschnitt der INF-Datei Ihres Geräts hinzufügen.

PortSelect=NO

Hinweis

Ein Nebeneffekt dieses Eintragswerts ist, dass der CreateFileName-Eintrag auf AUTO festgelegt ist. Wenn der Minidriver AUTO für den Dateinamen empfängt, muss er selbst bestimmen können, mit welchem Gerät er kommunizieren soll.

Hinweis

Für PropertyPages muss ein WIA-Treiber einen anderen Erweiterbarkeitsmechanismus verwenden, um Eigenschaftenseiten hinzuzufügen. Es muss auch seine eigene GUID zum Eintrag der UI-Klassen-ID in seinen INF-Dateien hinzufügen und eine spezifische Registrierung der Benutzeroberflächenerweiterung für die UI-Komponenten, die ersetzt oder ergänzt werden, wie allgemeine Dialogfelder, Kontextmenüs und Eigenschaftenseiten, vornehmen (siehe Registrierungseinträge für Benutzeroberflächenerweiterungen). Ein WIA-Treiber muss auch die Benutzeroberflächenerweiterungsregistrierung für die Komponente selbst bereitstellen.

Andere INF-Dateieinträge

Die Einträge in der folgenden Tabelle müssen innerhalb des Abschnitts platziert werden, auf den die INF-AddReg-Direktive des Geräts verweist:

INF-Dateieintrag Wert Kommentare
HardwareConfig Gibt den Typ der Verbindung an, die das Gerät verwendet.

1,1 − generisches WDM-Gerät

1,2 − SCSI-Gerät

1,4 − USB-Gerät

1,8 − serielles Gerät

1,16 − paralleles Gerät		 Wahlfrei
USDClass Gibt die GUID für den Minidriver an. Wahlfrei.

Die GUID in den EINTRÄGEn "USDClass " und "CLSID " muss mit der GUID übereinstimmen, die in der DllGetClassObject-Funktion des Minidrivers verwendet wird. Wenn Sie einen Mikrotreiber schreiben, sollte der Wert BB6CF8E2-1511-40bd-91BA-80D43C53064E sein. Andernfalls müssen Sie eine neue GUID generieren, z. B. genguid.exe.
CLSID- Gibt die GUID für den Minidriver an. Wahlfrei.

Sehen Sie sich die unmittelbar vorangehenden Kommentare für den USDClass-Eintrag an.

Das Standardklasseninstallationsprogramm für stille Bildgeräte unterstützt die standardmäßige INF CopyFiles-Direktive.

Die STANDARD-INF-Datei für stille Imagegerä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 dargestellt.

    Gerätetyp Einbeziehen Bedürfnisse
    IEEE 1394/SBP2 Include=sti.inf Needs=STI.SBP2Section
    USB Include=sti.inf Needs=STI.USBSection
    SCSI Include=sti.inf Needs=STI.SCSISection
    Serie Include=sti.inf Needs=STI. SerialSection

  • Ein "INF DDInstall-Dienste Abschnitt", auf den im Abschnitt "INF DDInstall-Dienste" der vom Anbieter bereitgestellten INF-Datei verwiesen werden muss, wie in der folgenden Tabelle dargestellt.

    Gerätetyp Einbeziehen Bedürfnisse
    1394/SBP2 Einfügen=sti.inf Needs=STI.SBP2Section.Services
    USB Include=sti.inf Needs=STI.USBSection.Services
    SCSI Include=sti.inf Needs=STI.SCSISection.Services
    Serie Include=sti.inf Needs=STI. SerialSection.Services

Weitere Anleitungen zum Erstellen von INF-Dateien für stille Bildgeräte finden Sie in jeder INF-Datei, die mit Windows bereitgestellt wird, die den Eintrag "SubClass=StillImage" enthält.

Um das Gerät als WIA-Gerät festzulegen, muss die INF-Datei des Minidrivers die folgenden Werte enthalten, die im DeviceData-Abschnitt der vom Anbieter bereitgestellten INF-Datei platziert werden.

INF-Dateieintrag Wert Kommentare
Server Lokal Legt das Gerät als lokales Gerät fest. Dies ist optional und wenn ein Anbieter keinen Eintragswert angibt, wird davon ausgegangen, dass das Gerät lokal ist. Das heißt, die WIA_DIP_SERVER_NAME-Eigenschaft ist auf "Lokal" festgelegt.
MicroDriver Vom Anbieter bereitgestellter .dll Dateinamen Dieser Eintrag sollte auf den Namen der vom Hersteller bereitgestellten DLL festgelegt werden, die den WIA-Mikrodriver implementiert.
UI-DLL Vom Anbieter bereitgestellter .dll Dateinamen Veraltet und nie verwendet. Früher hat dieser Eintrag den Namen der vom Anbieter bereitgestellten DLL-Datei der Benutzeroberfläche angegeben.
UI-Klassen-ID Vom Anbieter bereitgestellter Geräteklassenbezeichner Gibt an, welche Geräteklasse die vom Hersteller bereitgestellte Benutzeroberfläche unterstützt. Dies ist optional und wenn ein Anbieter keinen Eintragswert angibt, legt WIA die WIA_DIP_UI_CLSID Eigenschaft auf GUID_NULL fest, und die standardmäßige WIA-Benutzeroberfläche wird verwendet.
ICMProfiles Vom Anbieter bereitgestellter Farbprofilwert Gibt einen Wert an, der in die eigenschaft WIA_IPA_ICM_PROFILE_NAME gesetzt werden soll. Wenn kein Wert angegeben ist, wird das sRGB-Standardprofil sRGB Color Space Profile.icm verwendet.

Der MicroDriver-Eintrag ist nur erforderlich, wenn der Anbieter einen WIA-Mikrodriver bereitstellt.

Die Benutzeroberflächeneinträge (UI) sind nur erforderlich, wenn der Anbieter eine benutzerdefinierte Benutzeroberfläche für das Imageerstellungsgerät bereitstellt.

Bemerkungen

Wenn Sie eine INF-Datei für Scanner entwickeln, können Sie Microsoft OS-Deskriptoren verwenden, um Kompatibilitäts-ID-Funktionen zu aktivieren. In diesem Fall können Sie zulassen, dass ein Scannertreiber mit mehreren Scannermodellen kompatibel ist.