Supporto dei comandi del driver WIA
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:
Determinare se il comando inviato è un comando supportato.
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.