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