Valfria kommandon

Följande kommandon kan implementeras av mikrodrivrutinen, men det är inte nödvändigt.

CMD_GETSUPPORTEDFILEFORMATS

Anropas av WIA Flatbed Driver för att hämta antalet ytterligare filformat. Två medlemmar i den angivna VAL-strukturen bör fyllas i: lVal ska anges till antalet ytterligare filformat; pGuid bör peka på en matris med GUID:er i bildformat. Det minne som allokeras för den här matrisen hanteras av mikrodrivrutinen och bör endast frigöras av den.

Bildformat visas i wiadef.h eller kan definieras som anpassade format. Observera att eftersom formaten BMP (fil) och MEMORYBMP (minne) är obligatoriska format lägger WIA Flatbed Driver automatiskt till dem. Mikrodrivern bör inte lägga till dem i den utökade listan.

Det här kommandot är valfritt om inte enheten har stöd för extra filformat.

CMD_GETSUPPORTEDMEMORYFORMATS

Anropas av WIA Flatbed Driver för att hämta antalet ytterligare minnesformat. Två medlemmar i den angivna VAL-strukturen bör fyllas i: lVal ska anges till antalet ytterligare minnesformat; pGuid bör peka på en matris med GUID:er i bildformat. Minnet som har allokerats för den här matrisen ägs av minidrivrutinen och bör endast frigöras av den.

Bildformat visas i wiadef.h eller kan definieras som anpassade format. Observera att eftersom formaten BMP (fil) och MEMORYBMP (minne) är obligatoriska format lägger WIA Flatbed Driver automatiskt till dem. Mikrodrivrutinen bör inte lägga till dem i den utökade listan.

Det här kommandot är valfritt om inte enheten har stöd för extra minnesformat.

CMD_SETFORMAT

Klassdrivrutinen skickar det här kommandot för att ange det aktuella formatet enligt programmets begäran. PGuid-medlemmen i VAL-strukturen innehåller bildformatet GUID. Mikrodrivrutinen bör spara det här bildformat-ID:t i sitt privata sammanhang för att hålla reda på den aktuella bildformatinställningen.

Mikrodrivrutiner krävs för att endast stödja det här kommandot om de rapporterar utökade format. Eftersom klassdrivrutinen inte har någon möjlighet att validera data i förlängda format, är det mikrodrivrutinens ansvar att generera rätt data. När du överför data i ett utökat format bör alla data överföras, inklusive bildrubriker. Om drivrutinen till exempel rapporterar att den stöder JPEG-formatet måste alla JPEG-filer överföras, inte bara bildbitarna.

Klassdrivrutinen äger minnet som pekas på av pGuid-medlemmen i VAL-strukturen, så mikrodrivrutinen får inte frigöra det.

Observera att det här kommandot inte påverkar hur en mikrostyrenhet svarar på anrop till sin skanningsfunktion. Som vanligt måste mikrodrivrutinen kontrollera värdena för parametrarna lPhase, pScanInfo och lLength för den här funktionen och placera data i de buffertar som pekas ut av parametrarna pBuffer och pReceived efter behov.

Drivrutiner som endast stöder filer i WiaImgFmt_BMP- och WiaImgFmt_MEMORYBMP-format (standardformaten för mikrodrivrutiner) kan ta emot kommandot CMD_SETFORMAT. Dessa drivrutiner kan ignorera det här kommandot eftersom klassdrivrutinen hanterar alla dataöverföringar med standardformaten.

CMD_SETSCANMODE

Anropas av WIA Flatbed Driver för att ange genomsökningsläget – förhandsgranskning eller slutlig – för mikrodrivrutinens enhet. LVal-medlemmen i VAL-strukturen innehåller något av följande värden, som båda definieras i wiamicro.h:

• SCANMODE_PREVIEWSCAN − Förhandsvisningsläge

• SCANMODE_FINALSCAN − Slutligt genomsökningsläge

CMD_SETSTIDEVICEHKEY

Anropas av WIA Flatbed Driver för att tillåta att mikrodrivrutinen läser registerposter i den installerade registreringsdelen. Det här kommandot tillhandahåller STI-enhetens installerade register HKEY till mikrodrivrutinen, så att den kan komma åt enhetens privata registervärden. PHandle-medlemmen i VAL-strukturen innehåller en pekare till den HKEY som ges till WIA Flatbed Driver under STIInitialize-metoden. Det här är den överordnade HKEY i avsnittet för den installerade enheten. DeviceData-nyckeln kan öppnas direkt med hjälp av denna HKEY. Mer information finns i INF-filer för WIA-enheter .

Anmärkning

Den här nyckeln öppnas och stängs endast av WIA Flatbed Driver. Det är också giltigt endast under det här kommandot och CMD_INITIALIZE (se Nödvändiga kommandon). När dessa kommandon har returnerats är nyckeln inte längre giltig. HKEY-värdet får inte cachelagras.