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) |