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

另請參閱

IMDSPDevice 介面

IMDSPEnumDevice 介面