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 インターフェイス ポインターを取得する必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | sti.h (Sti.h を含む) |