Metodo IWiaItem::D eviceCommand (wia_xp.h)

Articolo
03/08/2023

IWiaItem::D eviceCommand invia un comando a un dispositivo hardware Windows Image Acquisition (WIA).

Sintassi

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

Parametri

[in] lFlags

Tipo: LONG

Attualmente inutilizzato. Deve essere impostato su zero.

[in] pCmdGUID

Tipo: GUID const*

Specifica un identificatore univoco che specifica il comando da inviare al dispositivo hardware WIA. Per un elenco di comandi di dispositivo validi, vedere Comandi del dispositivo WIA.

[in, out] pIWiaItem

Tipo: IWiaItem**

Nell'output, questo puntatore punta all'elemento creato dal comando, se presente.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Le applicazioni usano questo metodo per inviare comandi WIA ai dispositivi hardware.

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

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wia_xp.h (includere Wia.h)
Libreria	Wiaguid.lib
DLL	Wiaservc.dll

Condividi tramite