Método IWiaItem2::D eviceDlg

Exibe uma caixa de diálogo para o usuário se preparar para a aquisição de imagens.

Sintaxe

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
);

Parâmetros

lFlags [in]

Tipo: LONG

Especifica um conjunto de sinalizadores que controlam a operação da caixa de diálogo. O valor pode ser 0 para representar o comportamento padrão ou qualquer um dos sinalizadores de WIA_DEVICE_DIALOG descritos em WiaFlag.

hwndParent [in]

Digite: HWND

Um identificador para a janela pai.

bstrFolderName [in]

Tipo: BSTR

Especifica o nome da pasta para onde os arquivos devem ser transferidos.

bstrFilename [in]

Tipo: BSTR

Especifica o nome do arquivo de modelo.

plNumFiles [in]

Tipo: LONG*

Um ponteiro para o número de itens na matriz ppbstrFilePaths .

ppbstrFilePaths [in, out]

Tipo: BSTR**

O endereço de um ponteiro para uma matriz de caminhos para os arquivos verificados. Inicialize o ponteiro para apontar para uma matriz de tamanho zero (0) antes que IWiaItem2::D eviceDlg seja chamado.

ppIWiaItem2 [in, out]

Tipo: IWiaItem2**

O endereço de uma matriz de ponteiros para interfaces IWiaItem2 .

Valor retornado

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Esse método exibe uma caixa de diálogo para o usuário que um aplicativo usa para coletar todas as informações necessárias para a aquisição de imagens. Ele também é usado para especificar propriedades de verificação de imagem, como brilho e contraste.

Depois que esse método retorna, o aplicativo pode usar a interface IWiaTransfer para adquirir a imagem.

Os aplicativos devem chamar o método IUnknown::Release para cada elemento na matriz de ponteiros de interface que recebem por meio do parâmetro ppIWiaItem2 . Os aplicativos também devem liberar a matriz usando CoTaskMemFree.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	Wia.h
IDL	Wia.idl