MÉTHODE IMDServiceProvider ::EnumDevices (mswmdm.h)

  • Article

La méthode EnumDevices énumère les appareils physiques ou logiciels installés qui sont actuellement attachés et qui sont connus par le fournisseur de services.

Syntaxe

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

Paramètres

[out] ppEnumDevice

Pointeur vers une interface IMDSPEnumDevice . Si le fournisseur de services implémente IMDServiceProvider2 ::CreateDevice, cet énumérateur doit uniquement énumérer les appareils non Plug-and-Play.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :

  • Codes d’erreur COM standard
  • Codes d’erreur Windows convertis en valeurs HRESULT
  • Codes d’erreur Gestionnaire de périphériques Windows Media
Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Cette méthode est appelée sur les fournisseurs de services qui ne sont pas inscrits comme Plug-and-Play conscients (pour plus d’informations, consultez Activation de PnP pour les appareils et énumération d’appareils). Un fournisseur de services doit retourner uniquement l’énumérateur, qui énumère uniquement les appareils actuellement attachés à l’ordinateur et pris en charge par le fournisseur de services.

Cette méthode est appelée uniquement lorsqu’une application démarre ou lorsque l’application appelle IWMDeviceManager2 ::Reinitialize.

À l’heure actuelle, Windows Media Gestionnaire de périphériques ne prend pas en charge le retour des appareils installés.

Le fournisseur de services ne peut pas alerter l’application lorsque des appareils se connectent ou se déconnectent de l’ordinateur. Si un appareil Plug-and-Play se connecte ou se déconnecte et qu’une application implémente IWMDMNotification, Windows Media Gestionnaire de périphériques envoie une notification à l’application.

Cette méthode doit être implémentée. Elle ne doit pas retourner WMDM_E_NOTSUPPORTED ou E_NOTIMPL. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête mswmdm.h
Bibliothèque Mssachlp.lib

Voir aussi

Énumération des appareils

IMDServiceProvider Interface