IEnumWIA_DEV_CAPS::Next-Methode (wia_xp.h)

Artikel
03/06/2024

Die IEnumWIA_DEV_CAPS::Next-Methode füllt ein Array von Zeigern auf WIA_DEV_CAP Strukturen aus.

Syntax

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

Parameter

[in] celt

Typ: ULONG

Gibt die Anzahl der Arrayelemente in dem Array an, das durch den rgelt-Parameter angegeben wird.

[out] rgelt

Typ: WIA_DEV_CAP*

Zeiger auf ein Array von WIA_DEV_CAP Strukturen. IEnumWIA_DEV_CAPS::Next füllt dieses Array von Strukturen aus.

[in, out] pceltFetched

Typ: ULONG*

Bei der Ausgabe enthält dieser Parameter die Anzahl der Strukturzeiger, die tatsächlich in dem Array gespeichert sind, das durch den rgelt-Parameter angegeben wird.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Anwendungen verwenden diese Methode, um die Funktionen der einzelnen verfügbaren Windows Image Acquisition (WIA)-Hardwaregeräte abzufragen. Dazu übergibt die Anwendung einen Zeiger auf ein Array von WIA_DEV_CAP Strukturen, die sie ordnet. Außerdem wird die Anzahl der Arrayelemente im Parameter celt übergeben. Die IEnumWIA_DEV_CAPS::Next-Methode füllt das Array mit Strukturen. Anwendungen verwenden dann die Strukturen, um WIA-Hardwaregerätefunktionen aufzulisten.

WIA-Gerätefunktionen werden als Ereignisse und Befehle definiert, die vom Gerät unterstützt werden. Mithilfe des rgelt-Arrays übergibt IEnumWIA_DEV_CAPS::Next für jedes Vom Gerät unterstützte Ereignis und befehl eine einzelne Struktur an die Anwendung.

Beachten Sie, dass IEnumWIA_DEV_CAPS::Next die WIA_DEV_CAP Strukturen dynamisch anwendungen zuordnet. Daher müssen Anwendungen die WIA_DEV_CAP Strukturen löschen, die sie über den rgelt-Parameter erhalten. Anwendungen sollten SysFreeString verwenden, um die Felder bstrName, bstrDescription und bstrIcon aller WIA_DEV_CAP Strukturen frei zu geben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wia_xp.h (wia.h einschließen)
Bibliothek	Wiaguid.lib

Freigeben über