Méthode IPart ::EnumPartsIncoming (devicetopology.h)
La méthode EnumPartsIncoming obtient une liste de toutes les parties entrantes, c’est-à-dire les parties qui résident sur les chemins de données amont de cette partie.
Syntaxe
HRESULT EnumPartsIncoming(
[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 amont 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 EnumPartsIncoming é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 amont. |
|
Mémoire insuffisante. |
Remarques
Une application cliente peut parcourir une topologie d’appareil par rapport à la direction 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 amont à partir de la partie actuelle.
Si ce composant n’a aucun lien vers amont parties, 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 entrent dans une topologie d’appareil.
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 |