Metodo IWiaDevMgr2::SelectDeviceDlgID

Articolo
06/12/2023

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

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 di valori possibili, vedere Identificatori di 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 [out, retval]

Tipo: BSTR*

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

Valore restituito

Tipo: HRESULT

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il dispositivo è stato selezionato correttamente.
S_FALSE	L'utente ha annullato la finestra di dialogo.
WIA_S_NO_DEVICE_AVAILABLE	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 è stato selezionato correttamente, il metodo IWiaDevMgr2::SelectDeviceDlgID passa la stringa di identificatore all'applicazione tramite il relativo parametro pbstrDeviceID .

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::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 IWiaDevMgr2::SelectDeviceDlgID per visualizzare la finestra di dialogo passando 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 SelectDevice in modo che l'utente possa scegliere uno.

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	Wia.h
IDL	Wia.idl

Condividi tramite