IWiaItem::D eviceCommand-Methode (wia_xp.h)

Artikel
03/03/2024

Der IWiaItem::D eviceCommand gibt einen Befehl an ein Windows Image Acquisition (WIA)-Hardwaregerät aus.

Syntax

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

Parameter

[in] lFlags

Typ: LONG

Derzeit nicht verwendet. Sollte auf Null festgelegt werden.

[in] pCmdGUID

Typ: const GUID*

Gibt einen eindeutigen Bezeichner an, der den Befehl angibt, der an das WIA-Hardwaregerät gesendet werden soll. Eine Liste der gültigen Gerätebefehle finden Sie unter WIA-Gerätebefehle.

[in, out] pIWiaItem

Typ: IWiaItem**

In der Ausgabe zeigt dieser Zeiger auf das element, das vom Befehl erstellt wurde, falls vorhanden.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Anwendungen verwenden diese Methode, um WIA-Befehle an Hardwaregeräte zu senden.

Wenn die Anwendung den Befehl "WIA_CMD_TAKE_PICTURE", IWiaItem::D eviceCommand, an das Gerät sendet, erstellt das WIA-Laufzeitsystem das IWiaItem-Objekt , um das Bild darzustellen. Die IWiaItem::D eviceCommand-Methode speichert die Adresse der Schnittstelle im pIWiaItem-Parameter .

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wia_xp.h (wia.h einschließen)
Bibliothek	Wiaguid.lib
DLL	Wiaservc.dll

Share via