Método IWiaDevMgr2::CreateDevice
Cria uma árvore hierárquica de objetos IWiaItem2 para um dispositivo WIA (Aquisição de Imagens do Windows) 2.0.
Sintaxe
HRESULT CreateDevice(
[in] LONG lFlags,
[in] BSTR bstrDeviceID,
[out] IWiaItem2 **ppWiaItem2Root
);
Parâmetros
-
lFlags [in]
-
Tipo: LONG
Atualmente não utilizado. Deve ser definido como zero.
-
bstrDeviceID [in]
-
Tipo: BSTR
Especifica o identificador exclusivo do dispositivo WIA 2.0.
-
ppWiaItem2Root [out]
-
Tipo: IWiaItem2**
Recebe o endereço de um ponteiro para a interface IWiaItem2 do item raiz na árvore hierárquica para o dispositivo WIA 2.0.
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
Os aplicativos usam o método IWiaDevMgr2::CreateDevice para criar um objeto de dispositivo para os dispositivos WIA 2.0 especificados pelo parâmetro bstrDeviceID. Quando retorna, o método IWiaDevMgr2::CreateDevice armazena um endereço de um ponteiro no parâmetro ppWiaItem2Root, que aponta para o item raiz da árvore de objetos IWiaItem2 criados por IWiaDevMgr2::CreateDevice. Os aplicativos podem usar essa árvore de objetos para controlar e recuperar dados do dispositivo WIA 2.0.
Os aplicativos devem chamar o método IUnknown::Release nos ponteiros que recebem por meio do parâmetro ppWiaItem2Root .
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 |
|