IStillImageW::GetSTILaunchInformation-Methode (sti.h)

Artikel
02/07/2025

Die IStillImage::GetSTILaunchInformation Methode gibt den Grund zurück, warum die aufrufende Bildanwendung gestartet wurde, wenn der Stillbildereignismonitor sie gestartet hat.

Syntax

HRESULT GetSTILaunchInformation(
  [out]           LPWSTR pwszDeviceName,
  [out, optional] DWORD  *pdwEventCode,
  [out]           LPWSTR pwszEventName
);

Parameter

[out] pwszDeviceName

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, STI_MAX_INTERNAL_NAME_LENGTH Bytes länge, um den internen Gerätenamen des stillen Bildgeräts zu empfangen, für das die Anwendung gestartet wurde.

[out, optional] pdwEventCode

Reserviert für die zukünftige Verwendung.

[out] pwszEventName

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, der groß genug ist, um eine Zeichenfolgendarstellung einer GUID zu empfangen. Die GUID stellt die Still Image Device Events dar, für die die Anwendung gestartet wurde.

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

Wenn der Stillbildereignismonitor die Anwendung gestartet hat, identifizieren die werte pwszDeviceName und pwszEventName werte die /StiDevice und /StiEvent Befehlszeilenargumente (siehe Beschreibung von IStillImage::RegisterLaunchApplication). Wenn der Ereignismonitor die Anwendung nicht gestartet hat, gibt die Methode STIERR_GENERIC zurück.

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

Anforderungen

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

Freigeben über