Metodo IWiaItem2::D eviceDlg

Visualizza una finestra di dialogo per l'utente per preparare l'acquisizione dell'immagine.

Sintassi

HRESULT DeviceDlg(
  [in]      LONG      lFlags,
  [in]      HWND      hwndParent,
  [in]      BSTR      bstrFolderName,
  [in]      BSTR      bstrFilename,
  [in]      LONG      *plNumFiles,
  [in, out] BSTR      **ppbstrFilePaths,
  [in, out] IWiaItem2 **ppIWiaItem2
);

Parametri

lFlags [in]

Tipo: LONG

Specifica un set di flag che controllano l'operazione della finestra di dialogo. Il valore può essere 0 per rappresentare il comportamento predefinito o uno qualsiasi dei flag WIA_DEVICE_DIALOG descritti in WiaFlag.

hwndParent [in]

Tipo: HWND

Handle per la finestra padre.

bstrFolderName [in]

Tipo: BSTR

Specifica il nome della cartella in cui devono essere trasferiti i file.

bstrFilename [in]

Tipo: BSTR

Specifica il nome del file modello.

plNumFiles [in]

Tipo: LONG*

Puntatore al numero di elementi nella matrice ppbstrFilePaths .

ppbstrFilePaths [in, out]

Tipo: BSTR**

Indirizzo di un puntatore a una matrice di percorsi per i file analizzati. Inizializzare il puntatore in modo che punti a una matrice di dimensioni zero (0) prima che venga chiamato IWiaItem2::D eviceDlg .

ppIWiaItem2 [in, out]

Tipo: IWiaItem2**

Indirizzo di una matrice di puntatori alle interfacce IWiaItem2 .

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 utilizzato da un'applicazione per raccogliere tutte le informazioni necessarie per l'acquisizione di immagini. Viene usato anche per specificare le proprietà di analisi delle immagini, ad esempio luminosità e contrasto.

Al termine di questo metodo, l'applicazione può usare l'interfaccia IWiaTransfer 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 ppIWiaItem2 . Le applicazioni devono anche liberare la matrice usando CoTaskMemFree.

Requisiti