Sdílet prostřednictvím


Podpora příkazů ovladače WIA

Příkaz zařízení WIA je požadavek odeslaný službou WIA (jménem aplikace pro vytváření bitových kopií) na minidriver WIA a dává mu pokyn, aby provedl určitou akci.

Následuje seznam příkazů zařízení WIA, které se dají vystavit minidriveru:

Command Meaning
WIA_CMD_CHANGE_DOCUMENT Přejděte na další dokument (vydaný pouze pro skenery ve více dokumentech).
WIA_CMD_DELETE_ALL_ITEMS Odstraňte strom položek ovladače.
WIA_CMD_DIAGNOSTIC Vyhrazeno Microsoftem.
WIA_CMD_SYNCHRONIZE Znovu sestavte strom položek ovladače. Tento příkaz musí podporovat všichni minidriveři.
WIA_CMD_TAKE_PICTURE Pořídit snímek (vystavený jenom fotoaparátům)
WIA_CMD_UNLOAD_DOCUMENT Uvolněte aktuální dokument (vystavený pouze pro skenery ve více dokumentech).

Příkazy WIA_CMD_XXX jsou popsány v dokumentaci k sadě Microsoft Windows SDK. Můžete zahrnout vlastní seznam příkazů.

Přidání podpory příkazů zařízení

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.

Implementace IWiaMiniDrv::d rvDeviceCommand – metoda

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. Určete, jestli je příkaz odeslaný podporovaným příkazem.

  2. Zpracování žádosti o příkaz

The WIA driver should determine the WIA item that is to receive the device command by using the pWiasContext pointer. Ovladač WIA by pak měl zpracovat přijatý příkaz zařízení určený na příchozí položku WIA. Jakýkoli příkaz odeslaný na ovladač WIA, který není podporován, by měl být neúspěšný s kódem chyby E_INVALIDARG.

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