Condividi tramite


Metodo IWiaDevMgr2::CreateDevice

Crea un albero gerarchico di oggetti IWiaItem2 per un dispositivo Windows Image Acquisition (WIA) 2.0.

Sintassi

HRESULT CreateDevice(
  [in]  LONG      lFlags,
  [in]  BSTR      bstrDeviceID,
  [out] IWiaItem2 **ppWiaItem2Root
);

Parametri

lFlags [in]

Tipo: LONG

Attualmente inutilizzato. Deve essere impostato su zero.

bstrDeviceID [in]

Tipo: BSTR

Specifica l'identificatore univoco del dispositivo WIA 2.0.

ppWiaItem2Root [out]

Tipo: IWiaItem2**

Riceve l'indirizzo di un puntatore all'interfaccia IWiaItem2 dell'elemento radice nell'albero gerarchico per il dispositivo WIA 2.0.

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 il metodo IWiaDevMgr2::CreateDevice per creare un oggetto dispositivo per i dispositivi WIA 2.0 specificati dal parametro bstrDeviceID. Quando restituisce, il metodo IWiaDevMgr2::CreateDevice archivia un indirizzo di un puntatore nel parametro ppWiaItem2Root, che punta all'elemento radice degli oggetti IWiaItem2 creati da IWiaDevMgr2::CreateDevice. Le applicazioni possono usare questo albero di oggetti per controllare e recuperare i dati dal dispositivo WIA 2.0.

Le applicazioni devono chiamare il metodo IUnknown::Release nei puntatori ricevuti tramite il parametro ppWiaItem2Root .

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