Méthode IPart ::EnumPartsOutgoing (devicetopology.h)
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 |
|---|---|
|
Le pointeur ppParts a la valeur NULL. |
|
Cette partie n’a aucun lien vers les parties en aval. |
|
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 |