Metodo IWiaDevMgr::CreateDevice (wia_xp.h)

IWiaDevMgr::CreateDevice crea un albero gerarchico di oggetti IWiaItem per un dispositivo Windows Image Acquisition (WIA).

Sintassi

HRESULT CreateDevice(
  [in]  BSTR     bstrDeviceID,
  [out] IWiaItem **ppWiaItemRoot
);

Parametri

[in] bstrDeviceID

Tipo: BSTR

Specifica l'identificatore univoco del dispositivo WIA.

[out] ppWiaItemRoot

Tipo: IWiaItem**

Puntatore a un puntatore all'interfaccia IWiaItem dell'elemento radice nell'albero gerarchico per il dispositivo WIA.

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 IWiaDevMgr::CreateDevice per creare un oggetto dispositivo per i dispositivi WIA specificati dal parametro bstrDeviceID .

Quando restituisce, il metodo IWiaDevMgr::CreateDevice archivia un indirizzo di un puntatore nel parametro ppWiaItemRoot. Il puntatore punta all'elemento radice dell'albero degli oggetti IWiaItem creati da IWiaDevMgr::CreateDevice. Le applicazioni possono usare questo albero di oggetti per controllare e recuperare i dati dal dispositivo WIA.

Si noti che le applicazioni devono chiamare il metodo IUnknown::Release nei puntatori ricevuti tramite il parametro ppWiaItemRoot .

Requisiti