File INF per dispositivi WIA
Importante
Alcune informazioni contenute in questo articolo si applicano ai sistemi operativi Windows obsoleti.
Il programma di installazione della classe predefinito per i dispositivi ancora immagine ,sti_ci.dll, riconosce un set speciale di voci di file INF. All'interno di un file INF, queste voci devono essere inserite all'interno della sezione INF DDInstall di un dispositivo. Le voci sono descritte nella tabella seguente.
| Voce di file INF | valore | Commenti |
|---|---|---|
| Sottoclasse | StillImage | Necessario |
| DeviceType | 1 per gli scanner 2 per le fotocamere 3 per lo streaming video |
Necessario |
| DeviceSubType | Valore definito dal fornitore | Facoltativo |
| Connection | Per i dispositivi non Plug and Play connessi a porte seriali o parallele, può essere seriale o parallelo per limitare la scelta delle porte dell'utente durante l'installazione. | Facoltativo 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 tramite 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/cancella 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. |
Facoltativo Il bit 5 non è attualmente usato. Impostare questa voce nel file INF su 0x33 per supportare gli eventi push-button con lo scanner. |
| PropertyPages | Solo per Windows 98 e Windows 2000 Identifica il nome e il punto di ingresso di una DLL che crea pagine della finestra delle proprietà personalizzate per i dispositivi ancora immagine. Per altre informazioni sulla voce PropertyPages , vedere File INF per i dispositivi immagine ancora. |
Facoltativo Questa voce è destinata all'uso solo da parte dei driver STI ed è obsoleta per i driver WIA. Per informazioni sulle pagine delle proprietà relative agli sviluppatori di driver WIA, vedere la nota in PropertyPages che segue questa tabella. |
| DeviceData | Identifica una sezione dei dati fornita dal fornitore contenente le informazioni da archiviare nel Registro di sistema, sotto la chiave DeviceData . Per i dispositivi supportati da TWAIN, la sezione dei dati deve contenere una voce TwainDS (vedere Voci del Registro di sistema per i driver WIA) | Facoltativo |
| Eventi | Identifica una sezione dei dati fornita dal fornitore che elenca ancora gli eventi del dispositivo immagine. Ogni voce di questa sezione deve avere il formato seguente: EventName="String",{GUID},App EventName è il nome interno dell'evento, String è la stringa di visualizzazione dell'evento, IL GUID è il GUID dell'evento e App specifica l'applicazione di creazione dell'immagine da avviare quando si verifica l'evento. Per avviare l'applicazione attualmente registrata, usare un asterisco () perApp*. |
Necessario |
| PortSelect | Se l'installazione del dispositivo non richiede una pagina di selezione delle porte, il valore "no" fa sì che la pagina venga ignorata. Questo valore fa sì che il valore della voce CreateFileName (vedere la nota in CreateFileName e PortSelect seguendo questa tabella) venga impostato automaticamente su AUTO. Un valore di Message1 determina la visualizzazione di un messaggio fornito dal sistema e imposta il valore della voce CreateFileName su AUTO. Si applica sia agli scanner che alle fotocamere che richiedono l'installazione manuale. |
Facoltativo Si noti che per i dispositivi Plug and Play, PortSelect viene ignorato, ma il valore della voce CreateFileName deve essere impostato su AUTO per consentire a WIA di caricare il dispositivo. Usare la direttiva INF AddReg per aggiungere questa voce alla sezione INF DDInstall del file INF del dispositivo. |
Nota
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. Il nome del file non deve essere il nome di un file del disco. Rispondendo a tale query, il servizio WiA ottiene il nome del file del dispositivo dalla voce del Registro di sistema CreateFileName . I driverusbscan.sys e scsiscan.sys in modalità kernel creano questa voce, come nel programma di installazione della classe. Il minidriver riceve questo nome file chiamando il metodo IStiDeviceControl::GetMyDevicePortName . Il minidriver può quindi usare questo nome di file quando chiama la funzione CreateFile per aprire un handle al dispositivo. Se il dispositivo viene installato manualmente, il programma di installazione della classe crea la voce CreateFileName , impostandone il valore su uno che dipende dalla selezione dell'utente nella pagina di selezione della porta: COMX, LPTX o 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
Nota
Un effetto collaterale di questo valore di voce è che la voce CreateFileName è impostata su AUTO. Si noti che se il minidriver riceve AUTO per il nome del file, deve essere in grado di determinare autonomamente il dispositivo con cui deve comunicare.
Nota
Per PropertyPages, un driver WIA deve usare un meccanismo di estendibilità diverso per aggiungere pagine di proprietà. Deve anche aggiungere il proprio GUID alla voce ID classe dell'interfaccia utente nei file INF e deve fornire una registrazione specifica dell'estendibilità dell'interfaccia utente (vedere Voci del Registro di sistema dell'estensione dell'interfaccia utente) per i componenti dell'interfaccia utente da sostituire, ad esempio finestre di dialogo comuni o aggiunte, ad esempio menu di scelta rapida e pagine delle proprietà. Un driver WIA deve anche fornire la registrazione dell'estendibilità dell'interfaccia utente per il componente stesso.
Voci aggiuntive 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 | valore | Commenti |
|---|---|---|
| HardwareConfig | Indica il tipo di connessione utilizzato dal dispositivo. 1,1 − dispositivo WDM generico 1,2 − Dispositivo SCSI 1,4 − Dispositivo USB 1,8 − dispositivo seriale 1,16 − Dispositivo parallelo |
Facoltativo |
| USDClass | Indica il GUID per il minidriver. | facoltativo. Il GUID nelle voci USDClass e CLSID deve corrispondere al GUID usato nella funzione DllGetClassObject del minidriver. Se si scrive un microdriver, il valore deve essere BB6CF8E2-1511-40bd-91BA-80D43C53064E. In caso contrario, è necessario generare un nuovo GUID, usando, ad esempio, genguid.exe. |
| CLSID | Indica il GUID per il minidriver. | facoltativo. Vedere i commenti immediatamente precedenti per la voce USDClass . |
Il programma di installazione della classe predefinito per i dispositivi ancora immagine supporta la direttiva INF CopyFiles standard.
Il file INF predefinito per i dispositivi ancora immagine, sti.inf, definisce due sezioni di installazione per ogni tipo di dispositivo, come indicato di seguito:
Sezione INF DDInstall, a cui è necessario fare riferimento nella sezione DDInstall del file INF fornito dal fornitore, come illustrato nella tabella seguente.
Tipo di dispositivo Includi Esigenze 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.
Tipo di dispositivo Includi Esigenze 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 altre indicazioni sulla creazione di file INF per dispositivi ancora immagine, è possibile esaminare qualsiasi file INF fornito con Windows contenente la voce SubClass=StillImage.
Per designare il dispositivo come dispositivo WIA, il file INF minidriver deve contenere i valori seguenti inseriti nella sezione DeviceData del file INF fornito dal fornitore.
| Voce file INF | valore | Commenti |
|---|---|---|
| Server | Locale | Designa il dispositivo come dispositivo locale. Questo è facoltativo e se un fornitore non specifica un valore di voce, si presuppone che il dispositivo sia locale. Vale a dire, la proprietà WIA_DIP_SERVER_NAME è impostata su Local. |
| MicroDriver | Nome file fornito dal fornitore .dll | Questa voce deve essere impostata sul nome della DLL fornita dal fornitore che implementa il microdriver WIA. |
| DLL dell'interfaccia utente | Nome file fornito dal fornitore .dll | 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 della classe di 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 usata l'interfaccia utente WIA predefinita. |
| ICMProfiles | Valore del profilo di 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 sRGB standard sRGB Color Space Profile.icm . |
La voce MicroDriver è necessaria solo se il fornitore fornisce un microdriver WIA.
Le voci dell'interfaccia utente sono necessarie solo se il fornitore fornisce un'interfaccia utente personalizzata per il dispositivo di immagine.
Commenti
Quando si sviluppa un file INF per gli scanner, è possibile usare i descrittori del sistema operativo Microsoft per abilitare la funzionalità ID compatibilità. Quando si esegue questa operazione, è possibile consentire a un driver dello scanner di essere compatibile con più modelli di scanner.