Přidání podpory zásobníku dokumentů

Důležité

Tento článek obsahuje informace, které platí pro zastaralé operační systémy Windows.

Zásobník dokumentů je jednotka připojená ke skeneru nebo je integrovaná do skeneru, který automaticky podává papírové dokumenty do místa, kde se mají naskenovat. U skeneru se zásobníkem dokumentů je funkčnost vystavena a řízena přidáním vlastností obsažených v následujícím seznamu. V systému Windows Me a Windows XP jsou v kořenové položce umístěny následující vlastnosti:

• WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE

• WIA_DPS_VERTICAL_SHEET_FEED_SIZE

• WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE

• WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE

• WIA_DPS_SHEET_FEEDER_REGISTRATION

• WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES

• WIA_DPS_DOCUMENT_HANDLING_STATUS

• WIA_DPS_DOCUMENT_HANDLING_SELECT

• WIA_DPS_PAGES

V systému Windows Me a Windows XP jsou v podřízené položce umístěny následující volitelné vlastnosti zásobníku dokumentů:

• VELIKOST_STRÁNKY_WIA_DPS

• WIA_DPS_PAGE_WIDTH

• WIA_DPS_PAGE_HEIGHT

• WIA_IPS_ORIENTATION

Pokud má zařízení plošinový skener, podavač dokumentů a duplexní jednotku, ovladač hlásí vlastnost WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES jako FEED | FLAT | DUP. Ujistěte se, že jsou správně nastavené platné hodnoty pro WIA_DPS_DOCUMENT_HANDLING_SELECT.

Předpokládejme například, že aplikace hodlá provést duplexní skenování tří stránek z zásobníku dokumentů. K tomu aplikace nastaví vlastnost WIA_DPS_DOCUMENT_HANDLING_SELECT na (FEED | DUPLEX) a nastaví vlastnost WIA_DPS_PAGES na hodnotu 3. Pokud aplikace hodlá nejprve zkontrolovat přední stranu stránky, měla by nastavit WIA_DPS_DOCUMENT_HANDLING_SELECT vlastnost na FEEDER | DUPLEX | FRONT_FIRST. Po dokončení by aplikace měla přejít na podřízenou položku, ze které by měla požádat o přenos dat. Minidriver hlásí přední stranu první stránky v zásobníku jako jednu stránku, zadní stranu této stránky jako stránku dvě a přední stranu druhé stránky v zásobníku jako tři stránky.

Je důležité si uvědomit, že pokud zařízení má zásobník dokumentů, musí podporovat vlastnosti zásobníku dokumentů.

Získávání dat ze zásobníku dokumentů

Při implementaci metody IWiaMiniDrv::drvAcquireItemData, když skener získává obrázky ze zásobníku dokumentů, je nutné provést několik změn.

1. Aplikace přečte vlastnost WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES a určí, zda skener podporuje skenování pomocí zásobníku dokumentů.

2. Aplikace přečte vlastnost WIA_DPS_DOCUMENT_HANDLING_SELECT a určí, jestli je skener nastavený tak, aby skenoval pomocí podavače dokumentů.

3. Aplikace určuje, zda je v zásobníku dokumentu papír čtením WIA_DPS_DOCUMENT_HANDLING_STATUS. Pokud v zásobníku není žádný papír, nastavte WIA_DPS_DOCUMENT_HANDLING_STATUS na správný stavový kód a vraťte WIA_ERROR_PAPER_EMPTY z metody IWiaMiniDrv::drvAcquireItemData ihned po provedení pořízení.

4. Zkontrolujte vlastnost WIA_DPS_PAGES a určete chování skenování. Pokud je tato vlastnost nulová, naskenujte všechny stránky, dokud nebude zásobník prázdný. Pokud je pozitivní, zkontrolujte pouze počet stránek označených hodnotou obsaženou v WIA_DPS_PAGES vlastnosti.

5. Naskenujte požadovaný počet stránek tak, že řídíte smyčku, nepřetržitě skenujte a odesílejte data (jednu stránku po druhé) do aplikace WIA voláním metody IWiaMiniDrvCallBack::MiniDrvCallback. Následující příklad kódu ukazuje, jak to může fungovat:

   for(int x=1; x=Pagecount; x++)
   {
       \\ Tell scanner to scan an image.
       \\ Receive image data from scanner.
       \\ Send the just-scanned image to the registered application.
   }
   

6. Pokud je WIA_IPA_TYMED nastavena na TYMED_CALLBACK nebo TYMED_MULTIPAGE_CALLBACK, musí se po naskenování jedné stránky a před skenováním další stránky odeslat další zpráva (IT_MSG_NEW_PAGE). To se provádí voláním funkce nástroje služby WIA wiasSendEndOfPage.

Počet stran, které ovladač podavače dokumentů vrací, závisí na nastavení vlastnosti WIA_DPS_PAGES.

Pokud je WIA_DPS_PAGES nula

1. Pokud skener nemůže zkontrolovat první stránku, okamžitě vraťte kód chyby. To zahrnuje zablokování papíru a když skeneru dojde papír.

2. Pokud skener úspěšně naskenuje první stránku a dokáže pokračovat ve skenování, ale dojde mu papír, vraťte kód úspěchu WIA_STATUS_END_OF_MEDIA. To signalizuje aplikaci, že přenos byl úspěšný, ale skener má nedostatek papíru. Některé aplikace reagují na WIA_ERROR_PAPER_EMPTY stejným způsobem jako na WIA_STATUS_END_OF_MEDIA.

3. Pokud skener úspěšně prohledá první stránku a je schopen pokračovat ve skenování, ale dojde k chybě, která nezpůsobí ztrátu dat, vraťte WIA_STATUS_END_OF_MEDIA. Aplikace tak může obnovit a uložit všechny stránky, které byly zkontrolovány dříve, než došlo k chybě. Jakékoli následné kontroly by měly okamžitě vrátit kód chyby, dokud se skener správně neobnoví z selhání.

4. Pokud skener úspěšně prohledá první stránku a bude moct pokračovat ve skenování, ale dojde k chybě, která způsobí ztrátu dat, okamžitě vrátí kód chyby.

Pokud je WIA_DPS_PAGES pozitivní

1. Všechna pravidla, pro která je WIA_DPS_PAGES nula, se uplatní.

2. Pokud skeneru dojde papír před naskenováním požadovaného počtu stránek, vraťte WIA_STATUS_END_OF_MEDIA. To umožňuje aplikaci zavřít relaci skenování, čímž zachová počet stránek, které již naskenuje. Některé aplikace reagují na WIA_ERROR_PAPER_EMPTY stejným způsobem jako WIA_STATUS_END_OF_MEDIA.