IPart::EnumPartsIncoming-Methode (devicetopology.h)
Die EnumPartsIncoming-Methode ruft eine Liste aller eingehenden Teile ab, d. h. die Teile, die sich in Datenpfaden befinden, die aus diesem Teil Upstream werden.
Syntax
HRESULT EnumPartsIncoming(
[out] IPartsList **ppParts
);
Parameter
[out] ppParts
Zeiger auf eine Zeigervariable, in die die Methode die Adresse einer IPartsList-Schnittstelle schreibt, die die Liste der Teile kapselt, die sofort aus diesem Teil Upstream werden. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist für die Freigabe der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem er die Release-Methode der Schnittstelle aufruft. Wenn der EnumPartsIncoming-Aufruf fehlschlägt, ist *ppPartsNULL.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Zeiger ppParts ist NULL. |
|
Dieser Teil enthält keine Links zu Upstream Teilen. |
|
Nicht genügend Arbeitsspeicher. |
Hinweise
Eine Clientanwendung kann eine Gerätetopologie gegen die Richtung des Audiodatenflusses durchlaufen, indem sie diese Methode bei jedem Schritt des Durchlaufs iterativ aufruft, um die Liste der Teile abzurufen, die sofort Upstream aus dem aktuellen Teil liegen.
Wenn dieser Teil keine Links zu Upstream Teilen aufweist, gibt die Methode den Fehlercode E_NOTFOUND zurück und erstellt keine Teileliste (*ppParts ist NULL). Beispielsweise gibt die -Methode diesen Fehlercode zurück, wenn die IPart-Schnittstelle einen Connector darstellt, über den Daten in eine Gerätetopologie gelangen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | devicetopology.h |