Compatibilidad con comandos del controlador WIA
Un comando de dispositivo WIA es una solicitud enviada por el servicio WIA (en nombre de la aplicación de creación de imágenes) al minidriver WIA, instruyendo que realice una acción determinada.
A continuación se muestra una lista de comandos de dispositivo WIA que se pueden emitir a un minidriver:
| Get-Help | Significado |
|---|---|
| WIA_CMD_CHANGE_DOCUMENT | Cambie al siguiente documento (emitido solo para escáneres multidocumento). |
| WIA_CMD_DELETE_ALL_ITEMS | Elimine el árbol de elementos de controlador. |
| WIA_CMD_DIAGNOSTIC | Reservado por Microsoft. |
| WIA_CMD_SYNCHRONIZE | Vuelva a generar el árbol de elementos del controlador. Todos los minidrivers deben admitir este comando. |
| WIA_CMD_TAKE_PICTURE | Tome una foto (emitida solo a las cámaras). |
| WIA_CMD_UNLOAD_DOCUMENT | Descargue el documento actual (emitido solo para escáneres multidocumento). |
Los comandos WIA_CMD_XXX se describen en la documentación de Microsoft Windows SDK. Puede incluir su propia lista personalizada de comandos.
Agregar compatibilidad con comandos de dispositivo
Para configurar correctamente el minidriver WIA para informar de los comandos del dispositivo, informe de una matriz de comandos admitidos en el método IWiaMiniDrv::d rvGetCapabilities . Para obtener un ejemplo de implementación del método IWiaMiniDrv::d rvGetCapabilities , vea Agregar compatibilidad con eventos de interrupción.
Implemente el método IWiaMiniDrv::d rvDeviceCommand
El servicio WIA llama al método IWiaMiniDrv::d rvDeviceCommand en respuesta a la llamada de la aplicación al método IWiaItem::D eviceCommand (descrito en la documentación de Microsoft Windows SDK). El método IWiaMiniDrv::d rvDeviceCommand debe realizar las siguientes tareas:
Determine si el comando enviado es un comando compatible.
Procese la solicitud de comando.
El controlador WIA debe determinar el elemento WIA que va a recibir el comando del dispositivo mediante el puntero pWiasContext . A continuación, el controlador WIA debe procesar el comando de dispositivo recibido destinado al elemento WIA entrante. Se debe producir un error en cualquier comando enviado al controlador WIA que no es compatible con un código de error de E_INVALIDARG.
Para obtener un ejemplo de implementación del método IWiaMiniDrv::d rvDeviceCommand , vea Informing an Application of Item Tree Changes.