IMDSPEnumStorage::Next 方法 (mswmdm.h)
Next 方法會傳回下一個 celtIMDSPStorage 介面的指標。
語法
HRESULT Next(
[in] ULONG celt,
[out] IMDSPStorage **ppStorage,
[out] ULONG *pceltFetched
);
參數
[in] celt
要求的記憶體介面數目。
[out] ppStorage
由呼叫端配置的 celtIMDSPStorage 介面指標陣列。 如果沒有更多儲存媒體存在,或發生錯誤,則傳回 NULL 。 如果 celt 超過 1,呼叫端必須配置足夠的記憶體來儲存介面指標的 celt 數目。
[out] pceltFetched
接收所傳回介面計數的 ULONG 變數指標。
傳回值
方法會傳回 HRESULT。 Windows Media 裝置管理員 中的所有介面方法都可以傳回下列任何一種錯誤碼類別:
- 標準 COM 錯誤碼
- 轉換成 HRESULT 值的 Windows 錯誤碼
- Windows 媒體 裝置管理員 錯誤碼
備註
當沒有更多記憶體介面,或要求較少的記憶體介面時, Next 的傳回值會S_FALSE。 發生這種情況時,必須查詢 pceltFetched 參數,以判斷傳回多少介面。
儲存列舉值可能不會反映媒體插入和移除的效果。 在這種情況下,客戶端應該取得新的列舉值物件。
必須實作這個方法。 它不得傳回WMDM_E_NOTSUPPORTED或E_NOTIMPL。 如需詳細資訊,請參閱 強制和選擇性介面。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | mswmdm.h |
程式庫 | Mssachlp.lib |