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

Weitere Informationen

IStillImage::GetDeviceInfo

IStillImageW