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

IStillImage::GetSTILaunchInformation メソッドは、静止画像イベント モニターによって起動された場合に、呼び出し元の静止画像アプリケーションが開始された理由を返します。

構文

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

パラメーター

[out] pwszDeviceName

アプリケーションが開始された静止イメージ デバイスの内部デバイス名を受け取るための、バッファーへの呼び出し元指定のポインター (長さSTI_MAX_INTERNAL_NAME_LENGTHバイト)。

[out, optional] pdwEventCode

将来利用するために予約されています。

[out] pwszEventName

GUID の文字列表現を受け取るのに十分な大きさのバッファーへの呼び出し元指定ポインター。 GUID は、アプリケーションが開始された 静止画像デバイス イベント を表します。

戻り値

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

注釈

静止画像イベント モニターがアプリケーションを起動した場合、 pwszDeviceName と pwszEventName の 値は 、/StiDevice コマンド ライン引数と /StiEvent コマンド ライン引数を識別します ( IStillImage::RegisterLaunchApplication の説明を参照してください)。 イベント モニターがアプリケーションを起動しなかった場合、メソッドは STIERR_GENERICを返します。

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

要件