Metodo IWiaItem::D eviceDlg (wia_xp.h)

  • Articolo

Il metodo IWiaItem::D eviceDlg viene usato dalle applicazioni per visualizzare una finestra di dialogo all'utente per preparare l'acquisizione di immagini.

Sintassi

HRESULT DeviceDlg(
  [in]  HWND     hwndParent,
  [in]  LONG     lFlags,
  [in]  LONG     lIntent,
  [out] LONG     *plItemCount,
  [out] IWiaItem ***ppIWiaItem
);

Parametri

[in] hwndParent

Tipo: HWND

Handle della finestra padre della finestra di dialogo.

[in] lFlags

Tipo: LONG

Specifica un set di flag che controllano l'operazione della finestra di dialogo. Può essere impostato su uno dei valori seguenti:

Contrassegno Significato
0 Comportamento predefinito.
WIA_DEVICE_DIALOG_SINGLE_IMAGE Limitare la selezione delle immagini a una singola immagine nella finestra di dialogo acquisizione immagini del dispositivo.
WIA_DEVICE_DIALOG_USE_COMMON_UI Usare l'interfaccia utente di sistema, se disponibile, anziché l'interfaccia utente fornita dal fornitore. Se l'interfaccia utente del sistema non è disponibile, viene usata l'interfaccia utente del fornitore. Se nessuna dell'interfaccia utente è disponibile, la funzione restituisce E_NOTIMPL.

[in] lIntent

Tipo: LONG

Specifica il tipo di dati che l'immagine deve rappresentare. Per un elenco dei valori delle finalità dell'immagine, vedere Costanti finalità immagine.

Nota Questo metodo ignora tutte le finalità dell'immagine WIA_INTENT_IMAGE_*.
 

[out] plItemCount

Tipo: LONG*

Riceve il numero di elementi nella matrice indicati dal parametro ppIWiaItem .

[out] ppIWiaItem

Tipo: IWiaItem**

Riceve l'indirizzo di una matrice di puntatori alle interfacce IWiaItem .

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo visualizza una finestra di dialogo per l'utente usato da un'applicazione per raccogliere tutte le informazioni necessarie per l'acquisizione di immagini. Ad esempio, questa finestra di dialogo consente all'utente di selezionare le immagini da scaricare da una fotocamera. Quando si usa uno scanner, viene usato anche per specificare proprietà di analisi delle immagini, ad esempio luminosità e contrasto.

Dopo aver restituito questo metodo, l'applicazione può usare l'interfaccia IWiaDataTransfer per acquisire l'immagine.

Le applicazioni devono chiamare il metodo IUnknown::Release per ogni elemento nella matrice di puntatori di interfaccia ricevuti tramite il parametro ppIWiaItem . Le applicazioni devono anche liberare la matrice usando CoTaskMemFree.

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

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wia_xp.h (includere Wia.h)
Libreria Wiaguid.lib
DLL Wiaservc.dll