IWiaItem2::D eviceCommand, méthode

Article
06/13/2023

Émet une commande sur un appareil matériel d’acquisition d’images Windows (WIA) 2.0.

Syntaxe

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

Paramètres

lFlags [in]

Type : LONG

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

pCmdGUID [in]

Type : const GUID*

Spécifie la commande à envoyer à l’appareil WIA 2.0. Consultez Commandes d’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
E_CMDNOTSUPPORTED	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.

Notes

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_PICTURE à 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 .

Spécifications

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

Partager via