Metodo IWiaItem2::D eviceCommand

Articolo
06/13/2023

Invia un comando a un dispositivo hardware Windows Image Acquisition (WIA) 2.0.

Sintassi

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

Parametri

lFlags [in]

Tipo: LONG

Attualmente inutilizzato. Deve essere impostato su zero.

pCmdGUID [in]

Tipo: GUID const*

Specifica il comando da inviare al dispositivo WIA 2.0. Vedere Comandi del dispositivo WIA.

ppIWiaItem2 [in, out]

Tipo: IWiaItem2**

Riceve l'indirizzo di un puntatore all'elemento IWiaItem2 creato dal comando, se presente.

Valore restituito

Tipo: HRESULT

Oltre ai codici di errore COM standard, il metodo può restituire il valore seguente.

Codice restituito	Descrizione
E_CMDNOTSUPPORTED	Il comando non viene implementato per l'interfaccia IWiaItem2 in cui viene chiamato il metodo . Il valore numerico per questo errore non è ancora definito.

Commenti

Il comportamento di questo metodo è diverso a seconda della categoria del nodo in cui viene chiamato il metodo .

Quando l'applicazione invia il comando WIA_CMD_TAKE_PICTURE al dispositivo usando il metodo IWiaItem2::D eviceCommand , il sistema di runtime WIA 2.0 crea un oggetto IWiaItem2 per rappresentare l'immagine. Il metodo IWiaItem2::D eviceCommand archivia l'indirizzo dell'interfaccia nel parametro ppIWiaItem2 .

Le applicazioni devono chiamare il metodo IUnknown::Release sui puntatori di interfaccia ricevuti tramite il parametro ppIWiaItem2 .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Wia.h
IDL	Wia.idl

Condividi tramite