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