IStillImageW::GetDeviceList-Methode (sti.h)

Die IStillImage::GetDeviceList-Methode gibt Hardwaremerkmale für alle installierten Standbildgeräte zurück.

Syntax

HRESULT GetDeviceList(
        DWORD  dwType,
        DWORD  dwFlags,
  [out] DWORD  *pdwItemsReturned,
  [out] LPVOID *ppBuffer
);

Parameter

dwType

Reservierter Parameter, verwenden Sie NULL.

dwFlags

Reservierter Parameter, verwenden Sie NULL.

[out] pdwItemsReturned

Empfängt die Anzahl der STI_DEVICE_INFORMATION Strukturen, die im Puffer bereitgestellt werden, auf den von ppBuffer verwiesen wird.

[out] ppBuffer

Empfängt ein Handle für einen durch STI zugeordneten Puffer. Dieser Puffer enthält ein Array von STI_DEVICE_INFORMATION Strukturen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird einer der in stierr.h definierten Fehlercodes mit STIERR-Präfix zurückgegeben.

Hinweise

Die IStillImage::GetDeviceList-Methode gibt eine STI_DEVICE_INFORMATION-Struktur für jedes installierte Standbildgerät zurück. Strukturinhalte werden in der Regel zum Erstellen von Benutzeroberflächenanzeigen und zum Suchen des internen Namens eines Geräts verwendet.

Vor dem Aufrufen von IStillImage::GetDeviceList müssen Clients der IStillImage-COM-SchnittstelleIStillImage::StiCreateInstance aufrufen, um einen IStillImage-Schnittstellenzeiger abzurufen.

Wenn der Aufrufer das Array von STI_DEVICE_INFORMATION Strukturen verwendet hat, auf die von ppBuffer verwiesen wird, muss er die Zuordnung des Arrays aufheben, indem er LocalFree aufruft (siehe Microsoft Windows SDK Dokumentation).

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	sti.h (einschließlich Sti.h)

Weitere Informationen

IStillImage::GetDeviceInfo

IStillImageW