IWiaItem2::D eviceCommand-Methode

Artikel
06/13/2023

Gibt einen Befehl für ein Windows Image Acquisition (WIA) 2.0-Hardwaregerät aus.

Syntax

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

Parameter

lFlags [in]

Typ: LONG

Derzeit nicht verwendet. Sollte auf Null festgelegt werden.

pCmdGUID [in]

Typ: const GUID*

Gibt den Befehl an, der an das WIA 2.0-Gerät gesendet werden soll. Weitere Informationen finden Sie unter WIA-Gerätebefehle.

ppIWiaItem2 [in, out]

Typ: IWiaItem2**

Empfängt die Adresse eines Zeigers auf das IWiaItem2-Element , das vom Befehl erstellt wurde, sofern vorhanden.

Rückgabewert

Typ: HRESULT

Zusätzlich zu den standardmäßigen COM-Fehlercodes gibt die Methode möglicherweise den folgenden Wert zurück.

Rückgabecode	Beschreibung
E_CMDNOTSUPPORTED	Der Befehl ist nicht für die IWiaItem2-Schnittstelle implementiert, für die die -Methode aufgerufen wird. Der numerische Wert für diesen Fehler ist noch nicht definiert.

Bemerkungen

Das Verhalten dieser Methode ist abhängig von der Kategorie des Knotens, auf dem die Methode aufgerufen wird, unterschiedlich.

Wenn die Anwendung den Befehl WIA_CMD_TAKE_PICTURE mithilfe der IWiaItem2::D eviceCommand-Methode an das Gerät sendet, erstellt das WIA 2.0-Laufzeitsystem ein IWiaItem2-Objekt zur Darstellung des Bilds. Die IWiaItem2::D eviceCommand-Methode speichert die Adresse der Schnittstelle im ppIWiaItem2-Parameter .

Anwendungen müssen die IUnknown::Release-Methode für die Schnittstellenzeiger aufrufen, die sie über den ppIWiaItem2-Parameter erhalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Wia.h
IDL	Wia.idl

Freigeben über