Metodo IEnumWiaItem2::Next
Riempie una matrice di puntatori alle interfacce IWiaItem2 .
Sintassi
HRESULT Next(
[in] ULONG cElt,
[out] IWiaItem2 **ppIWiaItem2,
[in, out] ULONG *pcEltFetched
);
Parametri
-
cElt [in]
-
Tipo: ULONG
Specifica il numero di elementi della matrice nella matrice indicati dal parametro ppIWiaItem2 .
-
ppIWiaItem2 [out]
-
Tipo: IWiaItem2**
Riceve l'indirizzo di una matrice di puntatori dell'interfaccia IWiaItem2 . IEnumWiaItem2::Next riempie questa matrice con puntatori di interfaccia.
-
pcEltFetched [in, out]
-
Tipo: ULONG*
In output, questo parametro riceve il numero di puntatori di interfaccia effettivamente archiviati nella matrice indicata dal parametro ppIWiaItem2 . Al termine dell'enumerazione, questo parametro contiene zero.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Il sistema di run-time windows Image Acquisition (WIA) 2.0 rappresenta i dispositivi hardware WIA 2.0 come albero gerarchico degli oggetti IWiaItem2 . Le applicazioni usano il metodo IEnumWiaItem2::Next per ottenere un puntatore dell'interfaccia IWiaItem2 per ogni elemento nella cartella corrente dell'albero degli oggetti IWiaItem2 di un dispositivo hardware.
Per ottenere l'elenco dei puntatori, l'applicazione passa una matrice di puntatori di interfaccia IWiaItem2 allocati. Passa anche il numero di elementi della matrice nel parametro cElt. Il metodo IEnumWiaItem2::Next riempie la matrice con puntatori a interfacce IWiaItem2 .
Fino al completamento del processo di enumerazione, il metodo IEnumWiaItem2::Next restituisce S_OK. Ogni volta che esegue, imposta il valore a cui fa riferimento pcEltFetched al numero di elementi inseriti nella matrice. Quando IEnumWiaItem2::Next completa il processo di enumerazione degli oggetti IWiaItem2 , restituisce S_FALSE e imposta la posizione di memoria a cui fa riferimento pcEltFetched su zero.
Le applicazioni devono chiamare il metodo IUnknown::Release nei puntatori di interfaccia ricevuti tramite il parametro ppIWiaItem2 .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista [solo app desktop] |
| Server minimo supportato |
Windows Server 2008 [solo app desktop] |
| Intestazione |
|
| IDL |
|