Méthode IWiaItem ::D eviceCommand (wia_xp.h)

IWiaItem ::D eviceCommand émet une commande sur un périphérique matériel d’acquisition d’images Windows (WIA).

Syntaxe

HRESULT DeviceCommand(
  [in]      LONG       lFlags,
  [in]      const GUID *pCmdGUID,
  [in, out] IWiaItem   **pIWiaItem
);

Paramètres

[in] lFlags

Type : LONG

Actuellement inutilisé. Doit être défini sur zéro (0).

[in] pCmdGUID

Type : GUID const*

Spécifie un identificateur unique qui spécifie la commande à envoyer au périphérique matériel WIA. Pour obtenir la liste des commandes d’appareil valides, consultez Commandes d’appareil WIA.

[in, out] pIWiaItem

Type : IWiaItem**

Sur la sortie, ce pointeur pointe vers l’élément créé par la commande, le cas échéant.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les applications utilisent cette méthode pour envoyer des commandes WIA aux appareils matériels.

Lorsque l’application envoie la commande WIA_CMD_TAKE_PICTURE à l’appareil IWiaItem ::D eviceCommand, le système d’exécution WIA crée l’objet IWiaItem pour représenter l’image. La méthode IWiaItem ::D eviceCommand stocke l’adresse de l’interface dans le paramètre pIWiaItem .

Les applications doivent appeler la méthode IUnknown ::Release sur les pointeurs d’interface qu’elles reçoivent via le paramètre pIWiaItem .

Configuration requise