IStillImageW::GetDeviceInfo-Methode (sti.h)

Die IStillImage::GetDeviceInfo Methode gibt Hardwaremerkmale für ein angegebenes Stillbildgerä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 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 eine der STIERR-Präfixfehlercodes zurückgegeben, die in stierr.hdefiniert sind.

Bemerkungen

Die IStillImage::GetDeviceInfo Methode gibt eine STI_DEVICE_INFORMATION Struktur für das angegebene Stillbildgerät zurück. Strukturinhalte werden in der Regel zum Erstellen von Benutzeroberflächenanzeigen verwendet.

Vor dem Aufrufen IStillImage::GetDeviceInfomü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 der Puffer durch Aufrufen LocalFree- (in der Microsoft Windows SDK-Dokumentation beschrieben) behandelt werden.

Anforderungen

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

Siehe auch

IStillImage::GetDeviceList

IStillImageW-