MÉTHODE IMDServiceProvider2 ::CreateDevice (mswmdm.h)

  • Article

La méthode CreateDevice est appelée par le Gestionnaire de périphériques Windows Media pour obtenir le ou les objets IMDSPDevice correspondant à l’appareil canonique obtenu à partir du sous-système PnP. Cette méthode doit être implémentée pour la prise en charge de PnP et de Windows Explorer, mais dans le cas contraire, elle est facultative. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.

Syntaxe

HRESULT CreateDevice(
  [in]  LPCWSTR     pwszDevicePath,
  [out] DWORD       *pdwCount,
  [out] IMDSPDevice ***pppDeviceArray
);

Paramètres

[in] pwszDevicePath

Pointeur vers une chaîne null à caractères larges contenant le chemin d’accès de l’appareil détecté par Windows Media Gestionnaire de périphériques. Ce nom est obtenu à partir du sous-système PnP et est le nom canonique plus « $ # », où # est un nombre incrémenté automatiquement. Ce nom peut être transmis directement à des fonctions telles que CreateFile pour accéder à l’objet d’appareil du noyau sous-jacent. Le fournisseur de services doit créer un ou plusieurs objets IMDSPDevice de wrapper pour cet appareil.

[out] pdwCount

Pointeur vers un DWORD contenant le nombre d’objets IMDSPDevice créés.

[out] pppDeviceArray

Tableau d’interfaces IMDSPDevice représentant les appareils. En règle générale, il n’existe qu’un seul élément de tableau, mais un fournisseur de services peut créer plusieurs objets IMDSPDevice correspondant à un nom de chemin d’accès d’appareil s’il crée un objet IMDSPDevice pour chaque stockage de niveau supérieur. Cela est susceptible de changer à l’avenir, et le nombre peut être limité à 1.

Valeur retournée

Si la méthode réussit, elle retourne S_OK. Si la méthode échoue, elle retourne les codes d’erreur Windows Media Gestionnaire de périphériques.

Remarques

Windows Media Gestionnaire de périphériques appelle cette méthode au démarrage d’une application ou lorsqu’un appareil conforme Plug-and-Play se connecte à l’ordinateur.

Configuration requise

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

Voir aussi

Énumération des appareils

IMDServiceProvider2 Interface