Méthode IDeviceTopology ::GetPartById (devicetopology.h)
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 |
---|---|
|
Le paramètre nId n’est pas un ID local valide. |
|
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 |
Voir aussi
IAudioInputSelector ::GetSelection
IAudioInputSelector ::SetSelection
IAudioOutputSelector ::GetSelection
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour