Compartir a través de

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

  • Artículo

El método IEnumWIA_DEV_CAPS::Next rellena una matriz de punteros para WIA_DEV_CAP estructuras.

Sintaxis

HRESULT Next(
  [in]      ULONG       celt,
  [out]     WIA_DEV_CAP *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: WIA_DEV_CAP*

Puntero a una matriz de estructuras de WIA_DEV_CAP . IEnumWIA_DEV_CAPS::Next rellena esta matriz de estructuras.

[in, out] pceltFetched

Tipo: ULONG*

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

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Las aplicaciones usan este método para consultar las funcionalidades de cada dispositivo de hardware de adquisición de imágenes de Windows (WIA) disponible. Para ello, la aplicación pasa un puntero a una matriz de WIA_DEV_CAP estructuras que asigna. También pasa el número de elementos de matriz en el celt de parámetros. El método IEnumWIA_DEV_CAPS::Next rellena la matriz con estructuras. A continuación, las aplicaciones usan las estructuras para enumerar las funcionalidades del dispositivo de hardware WIA.

Las funcionalidades del dispositivo WIA se definen como eventos y comandos que admite el dispositivo. Con la matriz rgelt , IEnumWIA_DEV_CAPS::Next pasa una única estructura a la aplicación para cada evento y comando que admita el dispositivo.

Tenga en cuenta que IEnumWIA_DEV_CAPS::Next asigna dinámicamente las estructuras de WIA_DEV_CAP que proporciona a las aplicaciones. Por lo tanto, las aplicaciones deben eliminar las estructuras de WIA_DEV_CAP que reciben a través del parámetro rgelt . Las aplicaciones deben usar SysFreeString para liberar los campos bstrName, bstrDescription y bstrIcon de todas las estructuras de WIA_DEV_CAP .

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