IMDServiceProvider::EnumDevices 方法 (mswmdm.h)

EnumDevices 方法會列舉目前連結且由服務提供者已知的已安裝實體或軟體裝置。

語法

HRESULT EnumDevices(
  [out] IMDSPEnumDevice **ppEnumDevice
);

參數

[out] ppEnumDevice

IMDSPEnumDevice 介面的指標。 如果服務提供者實作 IMDServiceProvider2::CreateDevice,則此列舉值應該只列舉非 隨插即用 裝置。

傳回值

方法會傳回 HRESULT。 Windows Media 中的所有介面方法 裝置管理員 都可以傳回下列任何錯誤碼類別:

  • 標準 COM 錯誤碼
  • 轉換成 HRESULT 值的 Windows 錯誤碼
  • Windows Media 裝置管理員 錯誤碼
如需可能錯誤碼的廣泛清單,請參閱 錯誤碼

備註

在未註冊為 隨插即用感知 (的服務提供者上呼叫此方法,請參閱為裝置啟用 PnP列舉裝置以取得詳細數據) 。 服務提供者應該只傳回列舉值,只會列舉目前附加至計算機的裝置,並由服務提供者支援。

只有在應用程式啟動時,或應用程式呼叫 IWMDeviceManager2::Reinitialize 時,才會呼叫這個方法。

目前,Windows Media 裝置管理員 不支援傳回已安裝的裝置。

當裝置連線或中斷連線電腦時,服務提供者無法警示應用程式。 如果 隨插即用 裝置連線或中斷連線,且應用程式實作 IWMDMNotification,則 Windows Media 裝置管理員 會將通知傳送至應用程式。

這個方法必須實作。 它不得傳回WMDM_E_NOTSUPPORTED或E_NOTIMPL。 如需詳細資訊,請參閱 強制和選擇性介面

規格需求

需求
目標平台 Windows
標頭 mswmdm.h
程式庫 Mssachlp.lib

另請參閱

列舉裝置

IMDServiceProvider 介面