Metodo IWiaItem::D eviceCommand (wia_xp.h)

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