Compartir a través de

método IEnumWIA_DEV_INFO::Next (wia_xp.h)

  • Artículo

El método IEnumWIA_DEV_INFO::Next rellena una matriz de punteros a interfaces IWiaPropertyStorage .

Sintaxis

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

Parámetros

[in] celt

Tipo: ULONG

Especifica el número de elementos de matriz de la matriz indicados por el parámetro rgelt .

[out] rgelt

Tipo: IWiaPropertyStorage**

Recibe la dirección de una matriz de punteros de interfaz IWiaPropertyStorage . IEnumWIA_DEV_INFO::Next rellena esta matriz con punteros de interfaz.

[in, out] pceltFetched

Tipo: ULONG*

En la salida, este parámetro contiene el número de punteros de interfaz almacenados realmente en la matriz indicada por el parámetro rgelt .

Valor devuelto

Tipo: HRESULT

Aunque hay dispositivos que quedan para enumerar, este método devuelve S_OK. Devuelve S_FALSE cuando finaliza la enumeración. Si se produce un error en el método, devuelve un código de error COM estándar.

Comentarios

Las aplicaciones usan este método para consultar las propiedades de cada dispositivo de hardware de adquisición de imágenes de Windows (WIA) disponible. Para ello, la aplicación pasa una matriz de punteros de interfaz IWiaPropertyStorage que asigna. También pasa el número de elementos de matriz en el celt de parámetros. El método IEnumWIA_DEV_INFO::Next rellena la matriz con punteros a interfaces IWiaPropertyStorage . Las aplicaciones pueden consultar las interfaces de las propiedades que admite el dispositivo.

Las aplicaciones deben llamar al método IUnknown::Release en los punteros de interfaz que reciben a través del parámetro rgelt .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wia_xp.h (incluya Wia.h)
Library Wiaguid.lib