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

Article
02/28/2024

La méthode GetPartById obtient un composant identifié par son ID local.

Syntaxe

HRESULT GetPartById(
  [in]  UINT  nId,
  [out] IPart **ppPart
);

Paramètres

[in] nId

La partie à obtenir. Ce paramètre est l’ID local du composant. Pour plus d'informations, consultez la section Notes.

[out] ppPart

Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse de l’interface IPart de l’objet de composant identifié par nId. Grâce à cette méthode, l’appelant obtient une référence comptabilisée à l’interface. L’appelant est chargé de libérer l’interface, quand elle n’est plus nécessaire, en appelant la méthode Release de l’interface. Si l’appel GetPartById échoue, *ppPart a la valeur NULL.

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_INVALIDARG	Le paramètre nId n’est pas un ID local valide.
E_POINTER	Le pointeur ppPart a la valeur NULL.

Remarques

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. Lorsque vous avez un pointeur vers un objet de composant, vous pouvez appeler la méthode IPart ::GetLocalId pour obtenir l’ID local du composant.

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