IStillImageW::LaunchApplicationForDevice メソッド (sti.h)

IStillImage::LaunchApplicationForDevice メソッドは、指定した静止画像デバイスに対して指定されたアプリケーションを起動します。

構文

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

パラメーター

[in] pwszDeviceName

IStillImage::GetSTILaunchInformation または IStillImage::GetDeviceListを呼び出して取得した、内部デバイス名を表す文字列への呼び出し元指定ポインター。

[in] pwszAppName

IStillImage::RegisterLaunchApplication 呼び出すことによって登録されたアプリケーションの短い名前を表す文字列への呼び出し元が指定したポインター。

[in] pStiNotify

呼び出し元が指定した、デバイス イベントを記述する の STINOTIFY 構造体へのポインター。 通常、イベントの GUID は、IStiDevice::GetLastNotificationDataを呼び出すことによって取得されます。

戻り値

操作が成功した場合、メソッドはS_OKを返します。 それ以外の場合は、stierr.h で定義されている STIERR プレフィックス付きエラー コード返します。

備考

IStillImage::LaunchApplicationForDevice メソッドは、IStillImage::RegisterLaunchApplicationを呼び出すことによってのみ、自身を登録したアプリケーションを起動できます。 指定したイベントは、指定したデバイスがサポートするイベントである必要があります。 このメソッドは、デバイス イベントの発生を模倣し、デバイスからイベントをインターセプトして再ルーティングするアプリケーションに役立ちます。 ユーザーがスキャナーを起動すると、たとえば、スキャンしたイメージを保存するか、コピーを作成するか、FAX を送信するかをユーザーに尋ねるアプリケーションが考えられます。

IStillImage::LaunchApplicationForDevice 呼び出す前に、IStillImage COM インターフェイスのクライアントが IStillImage::StiCreateInstance 呼び出して、IStillImage インターフェイス ポインターを取得する必要があります。

例

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);
}

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	sti.h (Sti.h を含む)