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 |
| Library | Mssachlp.lib |