Metodo IEnumWIA_DEV_CAPS::Next (wia_xp.h)

Articolo
03/13/2024

Il metodo IEnumWIA_DEV_CAPS::Next riempie una matrice di puntatori per WIA_DEV_CAP strutture.

Sintassi

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

Parametri

[in] celt

Tipo: ULONG

Specifica il numero di elementi della matrice nella matrice indicata dal parametro rgelt .

[out] rgelt

Tipo: WIA_DEV_CAP*

Puntatore a una matrice di strutture WIA_DEV_CAP . IEnumWIA_DEV_CAPS::Next riempie questa matrice di strutture.

[in, out] pceltFetched

Tipo: ULONG*

Nell'output questo parametro contiene il numero di puntatori di struttura effettivamente archiviati nella matrice indicata dal parametro rgelt .

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Le applicazioni usano questo metodo per eseguire query sulle funzionalità di ogni dispositivo hardware Windows Image Acquisition (WIA) disponibile. A tale scopo, l'applicazione passa un puntatore a una matrice di WIA_DEV_CAP strutture allocate. Passa anche il numero di elementi della matrice nel parametro celt. Il metodo IEnumWIA_DEV_CAPS::Next riempie la matrice con strutture. Le applicazioni usano quindi le strutture per enumerare le funzionalità del dispositivo hardware WIA.

Le funzionalità del dispositivo WIA sono definite come eventi e comandi supportati dal dispositivo. Usando la matrice rgelt , IEnumWIA_DEV_CAPS::Next passa una singola struttura all'applicazione per ogni evento e comando supportato dal dispositivo.

Si noti che IEnumWIA_DEV_CAPS::Next alloca dinamicamente le strutture WIA_DEV_CAP fornite alle applicazioni. Pertanto, le applicazioni devono eliminare le strutture WIA_DEV_CAP ricevute tramite il parametro rgelt . Le applicazioni devono usare SysFreeString per liberare i campi bstrName, bstrDescription e bstrIcon di tutte le strutture WIA_DEV_CAP .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wia_xp.h (include Wia.h)
Libreria	Wiaguid.lib

Condividi tramite