IStiDevice::Subscribe メソッド (sti.h)

IStiDevice::Subscribe メソッドは、デバイス イベントの通知を受信するように呼び出し元を登録します。

構文

HRESULT Subscribe(
  [in, out] LPSTISUBSCRIBE lpSubsribe
);

パラメーター

[in, out] lpSubsribe

サブスクリプション パラメーター値を含む STISUBSCRIBE 構造体への呼び出し元指定のポインター。

戻り値

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

注釈

IStiDevice::Subscribe メソッドは、通常、デバイスからイベントをインターセプトして再ルーティングするアプリケーションによって呼び出されます。 メソッドを使用すると、これらのアプリケーションに 静止画像デバイス イベント の通知を受け取ることができ、適切なディスプレイ アプリケーションに制御をディスパッチできます。

STISUBSCRIBE 構造体で指定された内容に基づいて、呼び出し元は、Windows メッセージまたは Win32 イベント (SetEvent 呼び出しによって) によってデバイス イベントの通知を要求できます。

アプリケーションは、イベントの通知を受信すると、 IStiDevice::GetLastNotificationData を呼び出して、発生したイベントを確認できます。

IStiDevice::Subscribe を呼び出す前に、IStiDevice COM インターフェイスのクライアントは IStillImage::CreateDevice を呼び出して、指定されたデバイスへのアクセスを提供する IStiDevice インターフェイス ポインターを取得する必要があります。

要件

こちらもご覧ください

IStiDevice

IStiDevice::UnSubscribe

IStillImage::LaunchApplicationForDevice