共用方式為


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 介面指標,以提供指定裝置的存取權。

規格需求

需求
目標平台 桌面
標頭 sti.h (包含 Sti.h)

另請參閱

IStiDevice

IStiDevice::UnSubscribe

IStillImage::LaunchApplicationForDevice