Share via

IPart::EnumPartsOutgoing-Methode (devicetopology.h)

  • Artikel

Die EnumPartsOutgoing-Methode ruft eine Liste aller ausgehenden Teile ab, d. h. die Teile, die sich in Datenpfaden befinden, die sich in diesem Teil nachgelagerten Datenpfaden befinden.

Syntax

HRESULT EnumPartsOutgoing(
  [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 sich unmittelbar nach diesem Teil befinden. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist für das Freigeben der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem die Release-Methode der Schnittstelle aufgerufen wird. Wenn der EnumPartsOutgoing-Aufruf fehlschlägt, ist *ppPartsNULL.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_POINTER
 Zeiger ppParts ist NULL.
E_NOTFOUND
 Dieser Teil enthält keine Links zu nachgelagerten Teilen.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.

Hinweise

Eine Clientanwendung kann eine Gerätetopologie in Richtung des Audiodatenflusses durchlaufen, indem sie diese Methode bei jedem Schritt des Durchlaufs iterativ aufruft, um die Liste der Teile abzurufen, die unmittelbar nach dem aktuellen Teil liegen.

Wenn dieses Teil keine Links zu nachgeschalteten Teilen aufweist, gibt die Methode fehlercode E_NOTFOUND zurück und erstellt keine Teileliste (*ppParts ist NULL). Die Methode gibt beispielsweise diesen Fehlercode zurück, wenn die IPart-Schnittstelle einen Connector darstellt, über den Daten eine Gerätetopologie verlassen.

Ein Codebeispiel, das die EnumPartsOutgoing-Methode verwendet, finden Sie in der Implementierung der SelectCaptureDevice-Funktion in Gerätetopologien.

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