Metodo IEnumWIA_DEV_INFO::Next (wia_xp.h)

Articolo
03/03/2024

Il metodo IEnumWIA_DEV_INFO::Next riempie una matrice di puntatori alle interfacce IWiaPropertyStorage .

Sintassi

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

Riceve l'indirizzo di una matrice di puntatori all'interfaccia IWiaPropertyStorage . IEnumWIA_DEV_INFO::Next riempie questa matrice con puntatori di interfaccia.

[in, out] pceltFetched

Tipo: ULONG*

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

Valore restituito

Tipo: HRESULT

Anche se sono presenti dispositivi da enumerare, questo metodo restituisce S_OK. Restituisce S_FALSE al termine dell'enumerazione. Se il metodo ha esito negativo, restituisce un codice di errore COM standard.

Commenti

Le applicazioni usano questo metodo per eseguire query sulle proprietà di ogni dispositivo hardware WINDOWS Image Acquisition (WIA) disponibile. A tale scopo, l'applicazione passa una matrice di puntatori di interfaccia IWiaPropertyStorage allocati. Passa anche il numero di elementi della matrice nel parametro celt. Il metodo IEnumWIA_DEV_INFO::Next riempie la matrice con puntatori alle interfacce IWiaPropertyStorage . Le applicazioni possono eseguire query sulle interfacce per le proprietà supportate dal dispositivo.

Le applicazioni devono chiamare il metodo IUnknown::Release sui puntatori di interfaccia ricevuti tramite il parametro rgelt .

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