IWiaItem::D eviceCommand-Methode (wia_xp.h)
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 |