IStillImageW::LaunchApplicationForDevice-Methode (sti.h)
Die IStillImage::LaunchApplicationForDevice-Methode startet eine angegebene Anwendung für ein angegebenes Standbildgerät.
HRESULT LaunchApplicationForDevice(
[in] LPWSTR pwszDeviceName,
[in] LPWSTR pwszAppName,
[in] LPSTINOTIFY pStiNotify
);
[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.
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.
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.
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);
}
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | sti.h (einschließlich Sti.h) |