Compartilhar via

Método IEnumWIA_DEV_CAPS::Next (wia_xp.h)

  • Artigo

O método IEnumWIA_DEV_CAPS::Next preenche uma matriz de ponteiros para WIA_DEV_CAP estruturas.

Sintaxe

HRESULT Next(
  [in]      ULONG       celt,
  [out]     WIA_DEV_CAP *rgelt,
  [in, out] ULONG       *pceltFetched
);

Parâmetros

[in] celt

Tipo: ULONG

Especifica o número de elementos de matriz na matriz indicada pelo parâmetro rgelt .

[out] rgelt

Tipo: WIA_DEV_CAP*

Ponteiro para uma matriz de estruturas de WIA_DEV_CAP . IEnumWIA_DEV_CAPS::Next preenche essa matriz de estruturas.

[in, out] pceltFetched

Tipo: ULONG*

Na saída, esse parâmetro contém o número de ponteiros de estrutura realmente armazenados na matriz indicada pelo parâmetro rgelt .

Retornar valor

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 esse método para consultar os recursos de cada dispositivo de hardware WIA (Aquisição de Imagens do Windows) disponível. Para fazer isso, o aplicativo passa um ponteiro para uma matriz de estruturas de WIA_DEV_CAP alocadas. Ele também passa o número de elementos de matriz no celt de parâmetro. O método IEnumWIA_DEV_CAPS::Next preenche a matriz com estruturas. Em seguida, os aplicativos usam as estruturas para enumerar os recursos do dispositivo de hardware WIA.

Os recursos do dispositivo WIA são definidos como eventos e comandos compatíveis com o dispositivo. Usando a matriz rgelt , IEnumWIA_DEV_CAPS::Next passa uma única estrutura para o aplicativo para cada evento e comando que o dispositivo dá suporte.

Observe que IEnumWIA_DEV_CAPS::Next aloca dinamicamente as estruturas de WIA_DEV_CAP que ele fornece aos aplicativos. Portanto, os aplicativos devem excluir as estruturas WIA_DEV_CAP que recebem por meio do parâmetro rgelt . Os aplicativos devem usar SysFreeString para liberar os campos bstrName, bstrDescription e bstrIcon de todas as estruturas WIA_DEV_CAP .

Requisitos

Requisito Valor
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