Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Important
Alcune informazioni contenute in questo articolo si applicano ai sistemi operativi Windows obsoleti.
The default class installer for still image devices, sti_ci.dll, recognizes a special set of INF file entries. All'interno di un file INF, queste voci devono essere inserite nella sezione INF DDInstall di un dispositivo. Le voci sono descritte nella tabella seguente.
| Voce di file INF | Value | Comments |
|---|---|---|
| SubClass | StillImage | Required |
| DeviceType | 1 per gli scanner 2 per fotocamere 3 per il video streaming |
Required |
| DeviceSubType | Vendor-defined value | Optional |
| Connection | Per i dispositivi non Plug and Play connessi a porte seriali o parallele, questo può essere Seriale o Parallelo per limitare la scelta delle porte dell'utente durante l'installazione. | Optional Se non specificato, l'utente può selezionare qualsiasi porta seriale o parallela. |
| Capabilities | Specifica un numero convertito in flag di bit che identificano le funzionalità del dispositivo. Questi flag vengono archiviati nel Registro di sistema e sono disponibili per i componenti STI con la struttura STI_DEV_CAPS. Bit 0 − Imposta/cancella STI_GENCAP_NOTIFICATIONS in STI_DEV_CAPS. Bit 1 − Imposta/cancella STI_GENCAP_POLLING_NEEDED in STI_DEV_CAPS. Bit 2 − Imposta/cancella STI_GENCAP_GENERATE_ARRIVALEVENT in STI_DEV_CAPS. Bit 3 − Imposta/annulla STI_GENCAP_AUTO_PORTSELECT in STI_DEV_CAPS. Bit 4 − Imposta/cancella STI_GENCAP_WIA in STI_DEV_CAPS. Bit 5 − Imposta/cancella STI_GENCAP_SUBSET in STI_DEV_CAPS. |
Optional Il bit 5 non è attualmente utilizzato. Impostare questa voce nel file INF su 0x33 per supportare gli eventi di pressione del pulsante con lo scanner. |
| PropertyPages | Solo per Windows 98 e Windows 2000 Identifica il nome e il punto di ingresso di una DLL che crea schede delle proprietà personalizzate per dispositivi per immagini fisse. For more information about the PropertyPages entry, see INF Files for Still Image Devices. |
Optional Questa voce è destinata solo ai driver STI ed è obsoleta per i driver WIA. For information about property pages relevant to WIA driver developers, see the Note on PropertyPages following this table. |
| DeviceData | Identifies a vendor-supplied data section containing information to be stored in the registry, under the DeviceData key. Per i dispositivi supportati da TWAIN, la sezione dati deve contenere una voce TwainDS (vedere Voci del Registro di sistema per i driver WIA) | Optional |
| Events | Identifica una sezione dei dati fornita dal fornitore che elenca gli eventi del dispositivo di immagini statiche. Ogni voce in questa sezione deve avere il formato seguente: EventName="String",{GUID},App EventName is the event's internal name, String is the event's display string, GUID is the event's GUID, and App specifies the imaging application to be launched when the event occurs. To launch the currently registered application, use an asterisk () forApp*. |
Required |
| PortSelect | Se l'installazione del dispositivo non richiede una pagina di selezione delle porte, il valore "no" determina l'ignorata della pagina. This value also causes the CreateFileName entry value (see the Note on CreateFileName and PortSelect following this table) to be automatically set to AUTO. A value of Message1 causes a system-supplied message to be displayed, and sets the CreateFileName entry value to AUTO. Si applica sia agli scanner che alle fotocamere che richiedono l'installazione manuale. |
Optional For Plug and Play devices, PortSelect is ignored, but the device still must have the CreateFileName entry value set to AUTO in order for WIA to load the device. Usare la direttiva INF AddReg per aggiungere questa voce alla sezione INF DDInstall del file INF del dispositivo. |
Note
Per comunicare con un dispositivo, un client in modalità utente (un minidriver) deve chiedere al servizio WIA il nome del file del dispositivo e una stringa che specifica il nome dell'oggetto da creare o aprire. (The file name doesn't have to be the name of a disk file.) Responding to such a query, the WIA service obtains the device's file name from the CreateFileName registry entry. (The usbscan.sys and scsiscan.sys kernel-mode drivers create this entry, as does the class installer.) The minidriver receives this file name by calling the IStiDeviceControl::GetMyDevicePortName method. The minidriver can then use this file name when it calls the CreateFile function to open a handle to the device. If the device is installed manually, the class installer creates the CreateFileName entry, setting its value to one that depends on the user's selection on the port selection page: COMX, LPTX, or AUTO. Alcuni dispositivi (ad esempio scanner di rete) installati manualmente non richiedono una porta. In questi casi, la finestra di dialogo di selezione delle porte risultante può confondere gli utenti. È possibile impedire la visualizzazione di questa finestra di dialogo aggiungendo la voce seguente nella sezione INF DDInstall del file INF del dispositivo.
PortSelect=NO
Note
A side effect of this entry value is that the CreateFileName entry is set to AUTO. Si noti che se il minidriver riceve AUTO per il nome del file, deve essere in grado di determinare autonomamente con quale dispositivo deve comunicare.
Note
Per PropertyPages, un driver WIA deve usare un meccanismo di estendibilità diverso per aggiungere pagine delle proprietà. Deve anche aggiungere il proprio GUID alla voce ID classe dell'interfaccia utente nei suoi file INF e deve fornire una registrazione specifica per l'estendibilità dell'interfaccia utente (consultare Voci del Registro di sistema dell'estensione dell'interfaccia utente) per i componenti dell'interfaccia utente che vengono sostituiti, come le finestre di dialogo comuni, o aggiunti, come i menu contestuali e le pagine delle proprietà. Un driver WIA deve anche fornire la registrazione dell'estendibilità dell'interfaccia utente per il componente stesso.
Altri elementi del file INF
Le voci nella tabella seguente devono essere inserite all'interno della sezione a cui punta la direttiva INF AddReg del dispositivo:
| Voce di file INF | Value | Comments |
|---|---|---|
| HardwareConfig | Indica il tipo di connessione usato dal dispositivo. 1,1 − dispositivo WDM generico 1,2 − Dispositivo SCSI 1,4 − Dispositivo USB 1,8 − dispositivo seriale 1,16 − dispositivo parallelo |
Optional |
| USDClass | Indica il GUID per il minidriver. | Optional. The GUID in the USDClass and CLSID entries must match the GUID that is used in the DllGetClassObject function of the minidriver. Se stai scrivendo un microdriver, il valore deve essere BB6CF8E2-1511-40bd-91BA-80D43C53064E. Otherwise, you must generate a new GUID, using, for example, genguid.exe. |
| CLSID | Indica il GUID per il minidriver. | Optional. See the immediately preceding comments for the USDClass entry. |
Il programma di installazione predefinito della classe per i dispositivi di acquisizione immagini supporta la direttiva standard INF CopyFiles.
The default INF file for still image devices, sti.inf, defines two installation sections for each device type, as follows:
Sezione INF DDInstall a cui è necessario fare riferimento nella sezione DDInstall del file INF fornito dal fornitore, come illustrato nella tabella seguente.
Device Type Include Needs IEEE 1394/SBP2 Include=sti.inf Needs=STI.SBP2Section USB Include=sti.inf Needs=STI.USBSection SCSI Include=sti.inf Needs=STI.SCSISection Serial Include=sti.inf Needs=STI.SerialSection Sezione INF DDInstall Services, a cui è necessario fare riferimento nella sezione INF DDInstall.Services del file INF fornito dal fornitore, come illustrato nella tabella seguente.
Device Type Include Needs 1394/SBP2 Include=sti.inf Needs=STI.SBP2Section.Services USB Include=sti.inf Needs=STI.USBSection.Services SCSI Include=sti.inf Needs=STI.SCSISection.Services Serial Include=sti.inf Needs=STI.SerialSection.Services
Per ulteriori indicazioni sulla creazione di file INF per dispositivi immagine fissa, puoi consultare qualsiasi file INF fornito con Windows che contenga la voce SubClass=StillImage.
To designate the device as a WIA device, the minidriver INF file must contain the following values placed within the DeviceData section of the vendor-supplied INF file.
| Voce file INF | Value | Comments |
|---|---|---|
| Server | Local | Definisce il dispositivo come dispositivo locale. Questo è facoltativo e se un fornitore non specifica un valore di immissione, si presuppone che il dispositivo sia locale. Ovvero, la proprietà WIA_DIP_SERVER_NAME è impostata su Local. |
| MicroDriver | Vendor-supplied .dll file name | Questa voce deve essere impostata sul nome della DLL fornita dal fornitore che implementa il microdriver WIA. |
| UI DLL | Vendor-supplied .dll file name | Obsoleto e mai usato. In precedenza, questa voce indicava il nome del file DLL dell'interfaccia utente fornito dal fornitore. |
| ID classe dell'interfaccia utente | Identificatore di classe del dispositivo fornito dal fornitore | Indica la classe di dispositivo che l'interfaccia utente fornita dal fornitore è in grado di supportare. Questo è facoltativo e, se un fornitore non specifica un valore di voce, WIA imposta la proprietà WIA_DIP_UI_CLSID su GUID_NULL e viene utilizzata l'interfaccia utente WIA predefinita. |
| ICMProfiles | Valore del profilo colore fornito dal fornitore | Specifica un valore da inserire nella proprietà WIA_IPA_ICM_PROFILE_NAME. Se non viene specificato alcun valore, viene usato il profilo standard sRGB sRGB Color Space Profile.icm. |
The MicroDriver entry is required only if the vendor supplies a WIA microdriver.
Le voci dell'interfaccia utente sono necessarie solo se il fornitore fornisce un'interfaccia utente personalizzata per il dispositivo di creazione dell'immagine.
Remarks
Quando si sviluppa un file INF per gli scanner, è possibile usare i descrittori del sistema operativo Microsoft per abilitare la funzionalità dell'ID di compatibilità. Quando si esegue questa operazione, si consente a un driver dello scanner di essere compatibile con più modelli di scanner.