Metodo IWiaDevMgr::SelectDeviceDlgID (wia_xp.h)

Il metodo IWiaDevMgr::SelectDeviceDlgID visualizza una finestra di dialogo che consente all'utente di selezionare un dispositivo hardware per l'acquisizione di immagini.

Sintassi

HRESULT SelectDeviceDlgID(
  [in]          HWND hwndParent,
  [in]          LONG lDeviceType,
  [in]          LONG lFlags,
  [out, retval] BSTR *pbstrDeviceID
);

Parametri

[in] hwndParent

Tipo: HWND

Handle della finestra proprietaria della finestra di dialogo Seleziona dispositivo .

[in] lDeviceType

Tipo: LONG

Specifica il tipo di dispositivo WIA da usare. Può essere impostato su StiDeviceTypeDefault, StiDeviceTypeScanner o StiDeviceTypeDigitalCamera.

[in] lFlags

Tipo: LONG

Specifica il comportamento della finestra di dialogo. Può essere impostato su uno dei valori seguenti:

[out, retval] pbstrDeviceID

Tipo: BSTR*

Puntatore a una stringa che riceve la stringa di identificatore del dispositivo.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce i valori seguenti:

Commenti

Questo metodo funziona in modo simile a IWiaDevMgr::SelectDeviceDlg. La differenza principale è che se trova un dispositivo corrispondente, non crea l'albero gerarchico di oggetti IWiaItem per il dispositivo.

Come IWiaDevMgr::SelectDeviceDlg, il metodo IWiaDevMgr::SelectDeviceDlgID crea e visualizza la finestra di dialogo Seleziona dispositivo . In questo modo l'utente può selezionare un dispositivo WIA per l'acquisizione di immagini. Se un dispositivo è selezionato correttamente, il metodo IWiaDevMgr::SelectDeviceDlgID passa la stringa dell'identificatore all'applicazione tramite il relativo parametro pbstrDeviceID .

È possibile visualizzare determinati tipi di dispositivi all'utente specificando i tipi di dispositivo tramite il parametro lDeviceType . Se solo un dispositivo soddisfa la specifica, IWiaDevMgr::SelectDeviceDlgID non visualizza la finestra di dialogo Seleziona dispositivo . Passa invece la stringa di identificatore del dispositivo all'applicazione senza visualizzare la finestra di dialogo. È possibile eseguire l'override di questo comportamento e forzare IWiaDevMgr::SelectDeviceDlgID per visualizzare la finestra di dialogo Seleziona dispositivo passando WIA_SELECT_DEVICE_NODEFAULT come valore per il parametro lFlags .

Se più dispositivi WIA corrispondono alla specifica, tutti i dispositivi corrispondenti vengono visualizzati nella finestra di dialogo Seleziona dispositivo in modo che l'utente possa sceglierne uno.

È consigliabile che le applicazioni rendano disponibile la selezione di dispositivi e immagini tramite una voce di menu denominata Da scanner o fotocamera dal menu File .

Requisiti