Partager via

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

  • Article

La méthode EnumPartsOutgoing récupère une liste de toutes les parties sortantes, c’est-à-dire les parties qui résident sur les chemins de données qui sont en aval de cette partie.

Syntaxe

HRESULT EnumPartsOutgoing(
  [out] IPartsList **ppParts
);

Paramètres

[out] ppParts

Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse d’une interface IPartsList qui encapsule la liste des parties qui sont immédiatement en aval de cette partie. Grâce à cette méthode, l’appelant obtient une référence comptée à l’interface. L’appelant est chargé de libérer l’interface, lorsqu’elle n’est plus nécessaire, en appelant la méthode Release de l’interface. Si l’appel EnumPartsOutgoing échoue, *ppParts 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_POINTER
 Le pointeur ppParts a la valeur NULL.
E_NOTFOUND
 Cette partie n’a aucun lien vers les parties en aval.
E_OUTOFMEMORY
 Mémoire insuffisante.

Remarques

Une application cliente peut parcourir une topologie d’appareil dans le sens du flux de données audio en appelant de manière itérative cette méthode à chaque étape de la traversée pour obtenir la liste des parties qui se trouvent immédiatement en aval de la partie actuelle.

Si ce composant n’a aucun lien vers des parties en aval, la méthode retourne le code d’erreur E_NOTFOUND et ne crée pas de liste de parties (*ppParts a la valeur NULL). Par exemple, la méthode retourne ce code d’erreur si l’interface IPart représente un connecteur par lequel les données quittent une topologie d’appareil.

Pour obtenir un exemple de code qui utilise la méthode EnumPartsOutgoing , consultez l’implémentation de la fonction SelectCaptureDevice dans Topologies d’appareils.

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

IPart Interface

IPartsList, interface