Het maken van Push-Model Aware Applications

Een toepassing die zich bewust is van het push-model, is een toepassing die zich heeft geregistreerd bij Microsoft STI, zodat deze automatisch kan worden geactiveerd wanneer er een gebeurtenis van een stilstaande beeldapparaat is opgetreden. Een toepassing kan pushmodelbewust worden gemaakt door een van de volgende twee methoden:

• IStillImage::RegisterLaunchApplication aanroepen. De aanroep kan worden gedaan door de toepassing of door het installatieprogramma.

• Inclusief een vermelding in het INF-bestand (Setup Information) van de toepassing. Naar de vermelding moet worden verwezen door een INF AddReg-richtlijn in het INF-bestand. De syntaxis van de vermelding wordt geïllustreerd in het volgende voorbeeld:

  ; 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"
  

  Er zijn twee INF-bestandsvermeldingen vereist voor apparaten die pushmodelbewuste toepassingen ondersteunen: DeviceData en Events. Voor meer informatie, zie INF-bestanden voor Still Image Devices.

Een van deze methoden zorgt ervoor dat de toepassing wordt geregistreerd bij de Gebeurtenismonitor stilstaand beeld.

Als een toepassing is geregistreerd als push-model bewust, kan een gebruiker met behulp van het Configuratiescherm voor Scanners en Camera's Still Image Device Events aan de toepassing toewijzen. Daarnaast kunnen leveranciers een eerste toewijzing van apparaat gebeurtenissen aan toepassingen bieden door toepassingsnamen in het INF-bestand van een apparaatstuurprogramma op te slaan. Een gebruiker kan deze eerste opdracht wijzigen met het Configuratiescherm Scanners en Camera's.

Nadat apparaatgebeurtenissen zijn toegewezen aan een toepassing, start de gebeurtenismonitor de toepassing wanneer een gebeurtenis van een toegewezen apparaatgebeurtenis wordt gedetecteerd.

Wanneer een pushmodelbewuste toepassing wordt geactiveerd, moet deze IStillImage::GetSTILaunchInformation aanroepen om de gebeurtenis en het apparaat te bepalen waarvoor deze is gestart. Vervolgens kan IStillImage::GetDeviceInfo worden aangeroepen voor meer informatie over het apparaat.

De toepassing moet de gebeurtenis afhandelen of er moet een gebruikersweergave worden gemaakt waarin wordt uitgelegd waarom de gebeurtenis niet kan worden verwerkt. Waarschijnlijk gebruikt de gebruiker vervolgens het Configuratiescherm om de apparaatgebeurtenis te koppelen aan een andere toepassing.

Het verwerken van de gebeurtenis betekent meestal dat er in een afbeelding wordt gelezen. Hiervoor roept de toepassing doorgaans een Image Acquisition-API aan, zoals TWAIN.

Als een toepassing is gestart omdat er een gebeurtenis is opgetreden, maar een API voor beeldverwerving het apparaat niet heeft geopend in de gegevensmodus (zie Overdrachtsmodi), zal de gebeurtenismonitor een andere instantie van de toepassing starten als er een andere gebeurtenis wordt gedetecteerd. De toepassing moet worden geïmplementeerd, zodat het meerdere exemplaren toestaat of (bij voorkeur) herkent wanneer het niet het eerste exemplaar is, een bericht verzendt naar het eerste exemplaar dat de gebeurtenis identificeert en wordt afgesloten.