Méthode IPart ::GetLocalId (devicetopology.h)

Article
03/02/2024

La méthode GetLocalId obtient l’ID local de ce composant.

Syntaxe

HRESULT GetLocalId(
  [out] UINT *pnId
);

Paramètres

[out] pnId

Pointeur vers une variable UINT dans laquelle la méthode écrit l’ID local de cette partie.

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
E_POINTER	Le pnId du pointeur a la valeur NULL.

Remarques

Lorsque vous avez un pointeur vers un objet de composant, vous pouvez appeler cette méthode pour obtenir l’ID local du composant. Un ID local est un nombre qui identifie de façon unique une partie parmi toutes les parties d’une topologie d’appareil.

Les méthodes IAudioInputSelector ::GetSelection et IAudioOutputSelector ::GetSelection récupèrent l’ID local d’un composant connecté. Les méthodes IAudioInputSelector ::SetSelection et IAudioOutputSelector ::SetSelection sélectionnent l’entrée ou la sortie connectée à un composant identifié par son ID local. La méthode IDeviceTopology ::GetPartById obtient un composant identifié par son ID local.

Pour obtenir des exemples de code qui utilisent la méthode GetLocalId , consultez les rubriques suivantes :

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