Compartilhar via

Método IWiaDevMgr::CreateDevice (wia_xp.h)

  • Artigo

O IWiaDevMgr::CreateDevice cria uma árvore hierárquica de objetos IWiaItem para um dispositivo WIA (Aquisição de Imagens do Windows).

Sintaxe

HRESULT CreateDevice(
  [in]  BSTR     bstrDeviceID,
  [out] IWiaItem **ppWiaItemRoot
);

Parâmetros

[in] bstrDeviceID

Tipo: BSTR

Especifica o identificador exclusivo do dispositivo WIA.

[out] ppWiaItemRoot

Tipo: IWiaItem**

Ponteiro para um ponteiro para a interface IWiaItem do item raiz na árvore hierárquica para o dispositivo WIA.

Valor retornado

Tipo: HRESULT

Se o 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 IWiaDevMgr::CreateDevice para criar um objeto de dispositivo para os dispositivos WIA especificados pelo parâmetro bstrDeviceID .

Quando retorna, o método IWiaDevMgr::CreateDevice armazena um endereço de um ponteiro no parâmetro ppWiaItemRoot. O ponteiro aponta para o item raiz da árvore de objetos IWiaItem criados por IWiaDevMgr::CreateDevice. Os aplicativos podem usar essa árvore de objetos para controlar e recuperar dados do dispositivo WIA.

Observe que os aplicativos devem chamar o método IUnknown::Release nos ponteiros que recebem por meio do parâmetro ppWiaItemRoot .

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wia_xp.h (inclua Wia.h)
Biblioteca Wiaguid.lib
DLL Wiaservc.dll