Freigeben über


IStillImageW::GetDeviceInfo-Methode (sti.h)

Die IStillImage::GetDeviceInfo-Methode gibt Hardwaremerkmale für ein angegebenes Standbildgerät zurück.

Syntax

HRESULT GetDeviceInfo(
  [in]  LPWSTR pwszDeviceName,
  [out] LPVOID *ppBuffer
);

Parameter

[in] pwszDeviceName

Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die einen internen Gerätenamen darstellt, abgerufen durch Aufrufen von IStillImage::GetSTILaunchInformation oder IStillImage::GetDeviceList.

[out] ppBuffer

Empfängt ein Handle für eine STI_DEVICE_INFORMATION-Struktur .

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::GetDeviceInfo-Methode gibt eine STI_DEVICE_INFORMATION-Struktur für das angegebene Standbildgerät zurück. Strukturinhalte werden in der Regel zum Erstellen von Benutzeroberflächenanzeigen verwendet.

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

Wenn der Aufrufer die STI_DEVICE_INFORMATION Struktur verwendet hat, auf die von ppBuffer verwiesen wird, muss er die Zuordnung des Puffers durch Aufrufen von LocalFree (in der Microsoft Windows SDK-Dokumentation beschrieben) beheben.

Anforderungen

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

Weitere Informationen

IStillImage::GetDeviceList

IStillImageW