Metodo IWiaDevMgr2::SelectDeviceDlg
Visualizza una finestra di dialogo che consente all'utente di selezionare un dispositivo hardware per l'acquisizione di immagini.
Sintassi
HRESULT SelectDeviceDlg(
[in] HWND hwndParent,
[in] LONG lDeviceType,
[in] LONG lFlags,
[in, out] BSTR *pbstrDeviceID,
[out, retval] IWiaItem2 **ppItemRoot
);
Parametri
-
hwndParent [in]
-
Tipo: HWND
Specifica la finestra padre della finestra di dialogo Seleziona dispositivo .
-
lDeviceType [in]
-
Tipo: LONG
Specifica il tipo di dispositivo WIA 2.0 da usare. Per un elenco dei valori possibili, vedere Identificatori del tipo di dispositivo WIA .
-
lFlags [in]
-
Tipo: LONG
Specifica il comportamento della finestra di dialogo. Il valore può essere uno dei seguenti.
-
0
-
Usare il comportamento predefinito
-
WIA_SELECT_DEVICE_NODEFAULT
-
Visualizzare la finestra di dialogo anche se è presente un solo dispositivo corrispondente.
pbstrDeviceID [in, out]
Tipo: BSTR*
Nell'output riceve una stringa che contiene la stringa di identificatore del dispositivo. In input, passare l'indirizzo di un puntatore se queste informazioni sono necessarie o NULL se non è necessario.
ppItemRoot [out, retval]
Tipo: IWiaItem2**
Riceve l'indirizzo di un puntatore all'interfaccia IWiaItem2 dell'elemento radice dell'albero gerarchico che rappresenta il dispositivo WIA 2.0 selezionato. Se non viene trovato alcun dispositivo, riceve NULL.
Valore restituito
Tipo: HRESULT
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Il dispositivo è stato selezionato correttamente. |
|
L'utente ha annullato la finestra di dialogo. |
|
Nessun dispositivo hardware WIA 2.0 corrisponde alle specifiche indicate nel parametro lDeviceType . |
Commenti
Questo metodo crea e visualizza la finestra di dialogo Seleziona dispositivo in modo che l'utente possa selezionare un dispositivo WIA 2.0 per l'acquisizione di immagini. Se un dispositivo è selezionato correttamente, il metodo IWiaDevMgr2::SelectDeviceDlg crea un albero gerarchico di oggetti IWiaItem2 per il dispositivo. Archivia un puntatore all'interfaccia IWiaItem2 dell'elemento radice nel parametro ppItemRoot.
L'applicazione può limitare i dispositivi visualizzati all'utente a tipi specifici specificando i tipi di dispositivo tramite il parametro lDeviceType . Se solo un dispositivo soddisfa la specifica, IWiaDevMgr2::SelectDeviceDlg non visualizza la finestra di dialogo Seleziona dispositivo . Crea invece l'albero IWiaItem2 per il dispositivo e archivia un puntatore all'interfaccia IWiaItem2 dell'elemento radice nel parametro ppItemRoot. È possibile eseguire l'override di questo comportamento e forzare IWiaDevMgr2::SelectDeviceDlg per visualizzare la finestra di dialogo specificando WIA_SELECT_DEVICE_NODEFAULT come valore per il parametro lFlags . Se più di un dispositivo WIA 2.0 corrisponde alla specifica, tutti i dispositivi corrispondenti vengono visualizzati nella finestra di dialogo Seleziona dispositivo in modo che l'utente possa sceglierne uno.
Le applicazioni devono chiamare il metodo IUnknown::Release sui puntatori di interfaccia ricevuti tramite il parametro ppItemRoot .
Nota
È consigliabile che le applicazioni rendano disponibile la selezione di dispositivi e immagini tramite una voce di menu denominata Dallo scanner dal menu File .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista [solo app desktop] |
| Server minimo supportato |
Windows Server 2008 [solo app desktop] |
| Intestazione |
|
| IDL |
|