Partager via


Méthode IDeviceTopology ::GetDeviceId (devicetopology.h)

La méthode GetDeviceId obtient l’identificateur de l’appareil représenté par l’objet device-topology.

Syntaxe

HRESULT GetDeviceId(
  [out] LPWSTR *ppwstrDeviceId
);

Paramètres

[out] ppwstrDeviceId

Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse d’une chaîne à caractères larges terminée par null qui contient l’identificateur d’appareil. La méthode alloue le stockage pour la chaîne. L’appelant est chargé de libérer le stockage, lorsqu’il n’est plus nécessaire, en appelant la fonction CoTaskMemFree . Si l’appel GetDeviceId échoue, *ppwstrDeviceId a la valeur NULL. Pour plus d’informations sur CoTaskMemFree, consultez la documentation du Kit de développement logiciel (SDK) Windows.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour Description
D_POINTER
Le pointeur ppwstrDeviceId a la valeur NULL.
E_OUTOFMEMORY
Mémoire insuffisante.

Remarques

L’identificateur d’appareil obtenu à partir de cette méthode peut être utilisé comme paramètre d’entrée pour la méthode IMMDeviceEnumerator ::GetDevice .

Pour obtenir un exemple de code qui utilise la méthode GetDeviceId , consultez Utilisation de l’interface IKsControl pour accéder aux propriétés audio.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête devicetopology.h

Voir aussi

IDeviceTopology, interface

IMMDeviceEnumerator ::GetDevice