IPart::EnumPartsIncoming-Methode (devicetopology.h)

  • Artikel

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
E_POINTER
 Zeiger ppParts ist NULL.
E_NOTFOUND
 Dieser Teil enthält keine Links zu Upstream Teilen.
E_OUTOFMEMORY
 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

Weitere Informationen

IPart-Schnittstelle

IPartsList-Schnittstelle