Creazione di applicazioni consapevoli di Push-Model

Un'applicazione compatibile con il modello push è un'applicazione registrata presso Microsoft STI, in modo che possa essere attivata automaticamente quando si verifica un evento di un dispositivo di acquisizione immagini fisse. Un'applicazione può essere resa compatibile con il modello push con uno dei due metodi seguenti:

• Chiamata a IStillImage::RegisterLaunchApplication. La chiamata può essere effettuata dall'applicazione o dal relativo programma di installazione.

• Inclusione di una voce nel file INF (Setup Information) dell'applicazione. La voce deve fare riferimento a una direttiva INF AddReg nel file INF. La sintassi della voce è illustrata nell'esempio seguente:

  ; Register Application "Imaging" as a push-model aware application for use with the still image event monitor
  HKLM,"SOFTWARE\Microsoft\Windows\CurrentVersion\StillImage\Registered Applications",Imaging,,"%25%\KodakImg.Exe /StiDevice:%%1 /StiEvent:%%2"
  

  Sono necessarie due voci di file INF per i dispositivi che supportano applicazioni in grado di supportare applicazioni in grado di supportare il modello push: DeviceData ed Eventi. Per altre informazioni, vedere File INF per i dispositivi ancora immagine.

Uno di questi metodi fa sì che l'applicazione venga registrata con Still Image Event Monitor.

Se un'applicazione è registrata come compatibile con il modello push, un utente può assegnare Eventi del dispositivo immagine fissa all'applicazione tramite il Pannello di controllo scanner e telecamere. Inoltre, i fornitori possono fornire un'assegnazione iniziale di eventi del dispositivo alle applicazioni includendo i nomi delle applicazioni all'interno del file INF di un driver di dispositivo. Un utente può modificare questa assegnazione iniziale con il Pannello di controllo Scanner e fotocamere.

Dopo che gli eventi del dispositivo sono stati assegnati a un'applicazione, il monitoraggio eventi avvierà l'applicazione quando rileva un'occorrenza di un evento del dispositivo assegnato.

Quando viene attivata un'applicazione compatibile con il modello push, deve chiamare IStillImage::GetSTILaunchInformation per determinare l'evento e il dispositivo per cui è stato avviato. Può quindi chiamare IStillImage::GetDeviceInfo per ottenere altre informazioni sul dispositivo.

L'applicazione deve gestire l'evento oppure deve creare una visualizzazione utente che spiega perché non può gestire l'evento. Presumibilmente, l'utente userà quindi il Pannello di controllo per associare l'evento del dispositivo a un'altra applicazione.

La gestione dell'evento implica in genere la lettura di un'immagine. A tale scopo, l'applicazione chiama in genere un'API acquisizione immagini, ad esempio TWAIN.

Se un'applicazione è stata avviata perché si è verificato un evento, ma un'API di acquisizione di immagini non ha aperto il dispositivo in modalità dati (vedere Modalità di trasferimento), il monitoraggio eventi avvierà un'altra istanza dell'applicazione se viene rilevato un altro evento. L'applicazione deve essere implementata in modo che consenta a più istanze o (preferibilmente) di riconoscere quando non è la prima istanza, invia un messaggio alla prima istanza che identifica l'evento ed esce.