Condividi tramite

Supporto dei comandi del driver WIA

  • Articolo

Un comando del dispositivo WIA è una richiesta inviata dal servizio WIA (per conto dell'applicazione di creazione dell'immagine) al minidriver WIA, che indica di eseguire un'azione specifica.

Di seguito è riportato un elenco di comandi del dispositivo WIA che possono essere rilasciati a un minidriver:

Comando Significato
WIA_CMD_CHANGE_DOCUMENT Passare al documento successivo (rilasciato solo per scanner multidocumenti).
WIA_CMD_DELETE_ALL_ITEMS Eliminare l'albero degli elementi del driver.
WIA_CMD_DIAGNOSTIC Riservato da Microsoft.
WIA_CMD_SYNCHRONIZE Ricompilare l'albero degli elementi del driver. Tutti i minidriver devono supportare questo comando.
WIA_CMD_TAKE_PICTURE Scattare una foto (rilasciata solo alle fotocamere).
WIA_CMD_UNLOAD_DOCUMENT Scaricare il documento corrente (rilasciato solo agli scanner multidocumenti).

I comandi WIA_CMD_XXX sono descritti nella documentazione Microsoft Windows SDK. È possibile includere un elenco personalizzato di comandi.

Aggiungere il supporto dei comandi del dispositivo

Per configurare correttamente il minidriver WIA per segnalare i comandi del dispositivo, segnalare una matrice di comandi supportati nel metodo IWiaMiniDrv::d rvGetCapabilities . Per un esempio di implementazione del metodo IWiaMiniDrv::d rvGetCapabilities , vedere Aggiunta del supporto per gli eventi interrupt.

Implementare il metodo IWiaMiniDrv::d rvDeviceCommand

Il servizio WIA chiama il metodo IWiaMiniDrv::d rvDeviceCommand in risposta alla chiamata dell'applicazione al metodo IWiaItem::D eviceCommand (descritto nella documentazione di Microsoft Windows SDK). Il metodo IWiaMiniDrv::d rvDeviceCommand deve eseguire le attività seguenti:

  1. Determinare se il comando inviato è un comando supportato.

  2. Elaborare la richiesta di comando.

Il driver WIA deve determinare l'elemento WIA che deve ricevere il comando del dispositivo usando il puntatore pWiasContext . Il driver WIA deve quindi elaborare il comando del dispositivo ricevuto destinato all'elemento WIA in ingresso. Qualsiasi comando inviato al driver WIA non supportato non deve essere riuscito con un codice di errore E_INVALIDARG.

Per un esempio di implementazione del metodo IWiaMiniDrv::d rvDeviceCommand , vedere Informing an Application of Item Tree Changes.For an example implementation of the IWiaMiniDrv::d rvDeviceCommand method, see Informing an Application of Item Tree Changes.