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 |
|
| IDL |
|