IStillImageW::LaunchApplicationForDevice-Methode (sti.h)

Artikel
02/29/2024

Die IStillImage::LaunchApplicationForDevice-Methode startet eine angegebene Anwendung für ein angegebenes Standbildgerä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 von 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::RegisterLaunchApplication registriert wurde.

[in] pStiNotify

Vom Aufrufer bereitgestellter Zeiger auf eine STINOTIFY-Struktur , die ein Geräteereignis beschreibt. In der Regel wird die GUID des Ereignisses abgerufen, indem IStiDevice::GetLastNotificationData aufgerufen wird.

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::LaunchApplicationForDevice-Methode kann nur Anwendungen starten, die sich selbst registriert haben, indem IStillImage::RegisterLaunchApplication aufgerufen 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 den Benutzer beispielsweise fragen, ob er das gescannte Bild speichern, eine Kopie erstellen oder ein Fax senden möchte.

Vor dem Aufrufen von IStillImage::LaunchApplicationForDevice müssen Clients der IStillImage-COM-SchnittstelleIStillImage::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
Kopfzeile	sti.h (einschließlich Sti.h)

Freigeben über