IStillImageW::LaunchApplicationForDevice-Methode (sti.h)

Artikel
02/07/2025

Die IStillImage::LaunchApplicationForDevice Methode startet eine angegebene Anwendung für ein angegebenes Stillbildgerät.

Syntax

HRESULT LaunchApplicationForDevice(
  [in] LPWSTR      pwszDeviceName,
  [in] LPWSTR      pwszAppName,
  [in] LPSTINOTIFY pStiNotify
);

Parameter

[in] pwszDeviceName

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

[in] pwszAppName

Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die den Kurznamen einer Anwendung darstellt, die durch Aufrufen von IStillImage::RegisterLaunchApplicationregistriert wurde.

[in] pStiNotify

Vom Aufrufer bereitgestellter Zeiger auf eine STINOTIFY Struktur, die ein Geräteereignis beschreibt. In der Regel wird die GUID des Ereignisses durch Aufrufen IStiDevice::GetLastNotificationDataabgerufen.

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::LaunchApplicationForDevice--Methode kann nur Anwendungen starten, die sich selbst registriert haben, indem IStillImage::RegisterLaunchApplicationaufgerufen wird. Das angegebene Ereignis muss ein Ereignis sein, das vom angegebenen Gerät unterstützt wird. Die Methode imitiert das Auftreten eines Geräteereignisses und ist nützlich für Anwendungen, die Ereignisse von Geräten abfangen und umleiten. Wenn ein Benutzer den Scanner startet, kann eine solche Anwendung beispielsweise den Benutzer fragen, ob er das gescannte Bild speichern, eine Kopie erstellen oder ein Fax senden möchte.

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

Beispiele

HRESULT hRes;
hRes = pStiDevice->GetLastNotificationData(&pNotify);
if (!SUCCEEDED(hRes))
{
    DisplayOutput("->GetLastNotificationData returned %xh %u",
        hReturn,hReturn);
}

// Process or filter events here

// Send event on to app
hRes = pSti->LaunchApplicationForDevice(pStiInfoPtr->szDeviceInternalName,
     L"AppName",
     pNotify);
if (!SUCCEEDED(hRes))
{
    DisplayOutput("->LaunchApplicationForDevice on %S returned %xh %u",
        pStiInfoPtr->szDeviceInternalName,hReturn,hReturn);
}

Anforderungen

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

Freigeben über