IWiaItem2 ::D méthode eviceCommand

envoie une commande à un périphérique matériel WIA (Windows Image Acquisition) 2,0.

Syntaxe

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

Paramètres

lFlags [ dans]

Type : long

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

pCmdGUID [ dans]

Type : const GUID *

Spécifie la commande à envoyer à l’appareil WIA 2,0. Consultez commandes de l’appareil WIA.

ppIWiaItem2 [ in, out]

Type : IWiaItem2**

Reçoit l’adresse d’un pointeur vers l’élément IWiaItem2 créé par la commande, le cas échéant.

Valeur retournée

Type : HRESULT

En plus des codes d’erreur COM standard, la méthode peut retourner la valeur suivante.

Code de retour Description
_CMDNOTSUPPORTED E
La commande n’est pas implémentée pour l’interface IWiaItem2 sur laquelle la méthode est appelée. La valeur numérique de cette erreur n’est pas encore définie.

Remarques

Le comportement de cette méthode est différent selon la catégorie du nœud sur lequel la méthode est appelée.

Lorsque l’application envoie la commande WIA _ cmd _ Take _ image à l’appareil à l’aide de la méthode IWiaItem2 ::D EVICECOMMAND , le système d’exécution WIA 2,0 crée un objet IWiaItem2 pour représenter l’image. La méthode IWiaItem2 ::D evicecommand stocke l’adresse de l’interface dans le paramètre ppIWiaItem2 .

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2008 [ applications de bureau uniquement]
En-tête
WIA. h
MIDL
WIA. idl