IPortableDevice 介面 (portabledeviceapi.h)
IPortableDevice介面可讓您存取可攜式裝置。
若要建立並開啟此介面,請先使用CLSID_PortableDeviceFTM或CLSID_PortableDevice呼叫CoCreateInstance以擷取IPortableDevice介面,然後呼叫Open以開啟裝置的連線。
繼承
IPortableDevice介面繼承自IUnknown介面。 IPortableDevice 也有下列類型的成員:
方法
IPortableDevice介面具有這些方法。
IPortableDevice::建議 建議方法會註冊應用程式定義的回呼,以接收裝置事件。 |
IPortableDevice::Cancel Cancel 方法會取消這個介面上的擱置作業。 |
IPortableDevice::Capabilities Capabilities 方法會擷取用來查詢可攜式裝置功能的介面。 |
IPortableDevice::Close Close 方法會關閉與裝置的連線。 |
IPortableDevice::Content Content 方法會擷取可用來存取裝置上物件的介面。 |
IPortableDevice::GetPnPDeviceID GetPnPDeviceID 方法會擷取應用程式用來開啟裝置的隨插即用 (PnP) 裝置識別碼。 |
IPortableDevice::Open Open 方法會開啟應用程式與裝置之間的連線。 |
IPortableDevice::SendCommand SendCommand 方法會將命令傳送至裝置,並同步擷取結果。 |
IPortableDevice::Unadvise Unadvise 方法會取消註冊用戶端,以接收回呼通知。 如果您先前呼叫建議,則必須呼叫這個方法。 |
備註
用戶端介面的設計目的是要用於任何 WPD 物件;不需要為應用程式所參考的每個物件建立新的實例。 應用程式開啟 IPortableDevice 介面的實例之後,它應該開啟並快取它所需的任何其他 WPD 用戶端介面。
針對 Windows 7, IPortableDevice 支援兩個適用于 CoCreateInstance的 CLSID。 CLSID_PortableDevice 傳回不會匯總自由執行緒封送處理器的 IPortableDevice 指標; CLSID_PortableDeviceFTM 是新的 CLSID,會傳回 IPortableDevice 指標,以匯總自由執行緒封送處理器。 這兩個指標都支援相同的功能,否則為 。
位於單一線程 Apartment 中的應用程式應該使用 CLSID_PortableDeviceFTM ,因為這樣可消除介面指標封送處理的額外負荷。 舊 版應用程式仍支援CLSID_PortableDevice。
需求
目標平台 | Windows |
標頭 | portabledeviceapi.h |