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 |