Compartir a través de


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, lo que le indica 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:

Command Meaning
WIA_CMD_CHANGE_DOCUMENT Cambie al siguiente documento (emitido solo a escáneres multidocumento).
WIA_CMD_DELETE_ALL_ITEMS Elimine el árbol de elementos del controlador.
WIA_CMD_DIAGNOSTIC Reservado por Microsoft.
WIA_CMD_SYNCHRONIZE Recompile 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 a 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

To properly set up your WIA minidriver to report device commands, report an array of supported commands in the IWiaMiniDrv::drvGetCapabilities method. For an example implementation of the IWiaMiniDrv::drvGetCapabilities method, see Adding Interrupt Event Support.

Implemente el método IWiaMiniDrv::d rvDeviceCommand

The WIA service calls the IWiaMiniDrv::drvDeviceCommand method in response to the application's call to the IWiaItem::DeviceCommand method (described in the Microsoft Windows SDK documentation). The IWiaMiniDrv::drvDeviceCommand method should perform the following tasks:

  1. Determine si el comando enviado es un comando compatible.

  2. Procese la solicitud de comando.

The WIA driver should determine the WIA item that is to receive the device command by using the pWiasContext pointer. Después, el controlador WIA debe procesar el comando del dispositivo recibido destinado al elemento WIA entrante. Se debe producir un error en cualquier comando enviado al controlador WIA que no se admite con un código de error E_INVALIDARG.

For an example implementation of the IWiaMiniDrv::drvDeviceCommand method, see Informing an Application of Item Tree Changes.