共用方式為


應用程式的介面

本節說明使用 Windows Media 裝置管理員 SDK 與裝置通訊的應用程式所使用的介面或實作。 這裡使用的「應用程式」一詞表示任何存在於桌上型電腦上且需要與連線可攜式裝置進行高階通訊的可執行檔、外掛程式或 COM 物件。 這可以包括媒體播放機應用程式、需要直接存取可攜式裝置) 或播放次數計量 COM 物件時,Windows 媒體播放機外掛程式 (。

其中一些介面是由應用程式實作,而其他介面則由應用程式呼叫。 每個介面的檔會指出它是實作還是呼叫 (,如果是選擇性還是必要) 。

應用程式會使用下列介面或類別。

介面或類別 描述
CSecureChannelClient 類別 協助程式類別,可讓應用程式自行驗證、加密和解密資料,以及建立 MAC。
IWMDeviceManager 應用程式的最上層 Windows Media 裝置管理員 介面。
IWMDeviceManager2 提供進階列舉方法和其他方法,以擴充 IWMDeviceManager
IWMDeviceManager3 提供設定裝置列舉喜好設定的方法,以擴充 IWMDeviceManager2 介面。
IWMDMDevice 提供檢查和探索單一可攜式裝置的方法。
IWMDMDevice2 擴充 IWMDMDevice ,方法是讓裝置能夠取得支援的視訊格式、依名稱尋找儲存體,以及使用屬性頁。
IWMDMDevice3 藉由提供方法來查詢裝置是否有屬性、傳送裝置 I/O 控制碼,以及提供升級的方法來搜尋儲存體和擷取裝置格式功能,來擴充 IWMDMDevice2
IWMDMDeviceControl 提供控制裝置的方法。
IWMDMDeviceSession 將多個作業統合成一個會話,以改善裝置作業的效率
IWMDMEnumDevice 列舉連接至電腦的可攜式裝置。
IWMDMEnumStorage 列舉裝置上的儲存體。
IWMDMMetaData 設定及擷取中繼資料屬性 (,例如) 儲存體的作者、相簿、內容類型等等。
IWMDMObjectInfo 取得及設定資訊,控制 IWMDMDeviceControl 介面如何處理裝置上可播放的檔案
IWMDMRevoked 擷取可從中下載更新元件的 URL,如果傳輸失敗併發生撤銷錯誤。
IWMDMStorage 提供在裝置上檢查和探索儲存體 (檔案、資料夾、播放清單) 的方法。
IWMDMStorage2 擴充 IWMDMStorage ,方法是允許依名稱取得子儲存體,以及取得和設定擴充屬性。
IWMDMStorage3 藉由公開中繼資料來擴充 IWMDMStorage2
IWMDMStorage4 藉由提供方法來擷取儲存體的可用中繼資料子集,以及設定和擷取其他儲存體的參考清單,來擴充 IWMDMStorage3
IWMDMStorageControl 用來在裝置內插入、刪除或移動檔案,或在裝置與電腦之間插入、刪除或移動檔案。
IWMDMStorageControl2 擴充 IWMDMStorageControl ,方法是在將內容插入儲存體時設定目的地檔案名。
IWMDMStorageControl3 藉由傳遞IWMDMMetaData介面指標,來擴充IWMDMStorageControl2
IWMDMStorageGlobals 提供在裝置上擷取儲存媒體 (的全域資訊的方法,例如快閃 ROM 記憶卡) 。
IWMDRMDeviceApp 可讓應用程式執行裝置 DRM 元件的計量、授權同步處理和更新。
IWMDRMDeviceApp2 藉由提供新版本的QueryDeviceStatus方法來擴充IWMDRMDeviceApp

 

回呼介面

下列選擇性介面是由應用程式實作,以便追蹤非同步要求的進度,例如讀取或寫入要求。

介面 描述
IWMDMNotification 允許應用程式和服務提供者在裝置或記憶體儲存體 (,例如 RAM 卡) 連線或與電腦中斷連線時收到通知。
IWMDMOperation2 提供取得和設定擴充屬性的方法,以擴充 IWMDMOperation
IWMDMOperation3 藉由提供新的方法來傳輸未加密的資料,以提升效率,以擴充 IWMDMOperation
IWMDMOperation 允許應用程式控制在檔案傳輸期間從電腦讀取或寫入資料的方式。
IWMDMProgress2 提供狀態指示器來擴充 IWMDMProgress::End 方法。
IWMDMProgress3 藉由提供其他輸入參數來指定事件識別碼和內容特定資訊,以擴充 IWMDMProgress2
IWMDMProgress 允許應用程式追蹤作業進度,例如格式化媒體或檔案傳輸。

 

下圖顯示如何從根 IWMDeviceManager 介面取得大部分重要的應用程式介面。 應用程式藉由共同建立 MediaDevMgr 物件、要求 IComponentAuthenticate 介面、驗證元件,然後要求 IWMDeviceManager 來取得此根介面, (這些步驟會在 驗證應用程式) 中說明。 取得此根介面之後, 會呼叫 IWMDeviceManager::EnumDevices 來建立實作 IWMDMEnumDevice的物件。 依顯示的順序呼叫介面上的方法,可取得其他介面。 在基底介面上呼叫QueryInterface,以取得IWMDMDevice2等衍生介面。

在下圖中,衍生介面會以斜線標記標示,因此 「IWMDMStorage/2/3」 表示IWMDMStorage、IWMDMStorage2IWMDMStorage3

顯示如何在 Windows 媒體裝置管理員中取得主要應用程式介面的圖表。

程式設計參考