IMDSPStorage4::SetReferences 方法 (mswmdm.h)
SetReferences 方法會設定記憶體中包含的參考,該參考具有 (,例如播放清單/相簿) ,並覆寫此記憶體中任何先前存在的參考。
語法
HRESULT SetReferences(
[in] DWORD dwRefs,
[in] IMDSPStorage **ppISPStorage
);
參數
[in] dwRefs
傳入數位中包含的 IMDSPStorage 介面指標計數。 零是可接受的值,並重設記憶體以包含零參考。 在此情況下,不會刪除記憶體本身。
[in] ppISPStorage
用來設定記憶體中參考的 IMDSPStorage 介面指標數位的指標。 參考的順序符合這個陣列中對應 IWMDMStorage 介面指標的順序。 如果 dwRefs 也是零,NULL 是可接受的值。
傳回值
方法會傳回 HRESULT。 Windows Media 裝置管理員 中的所有介面方法都可以傳回下列任何一種錯誤碼類別:
- 標準 COM 錯誤碼
- 轉換成 HRESULT 值的 Windows 錯誤碼
- Windows 媒體 裝置管理員 錯誤碼
備註
任何有效的 IMDSPStorage 物件都可以包含在 ppIMDSPStorage 陣列中。 這包括資料夾和其他記憶體,其中包含參考本身 (建立,例如播放清單播放清單) 。
根據裝置中的支援層級, (它是否支援播放清單或巢狀播放清單) ,服務提供者應該適當地處理此方法。 如果裝置沒有傳入參考數位所需的支援層級,服務提供者應該傳回WMDM_E_NOTSUPPORTED。
如果參考包含已刪除的記憶體,則應該傳回WMDM_E_INTERFACEDEAD。
SetReferences 方法遵循抹除和載入模型。 傳遞的參考包含完整集合,而且應該完全取代記憶體物件上的任何現有參考。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | mswmdm.h |
程式庫 | Mssachlp.lib |