IPart::EnumPartsOutgoing-Methode (devicetopology.h)

Die EnumPartsOutgoing-Methode ruft eine Liste aller ausgehenden Teile ab, d. h. die Teile, die sich auf Datenpfaden befinden, die von diesem Teil nachgelagert sind.

Syntax

HRESULT EnumPartsOutgoing(
  [out] IPartsList **ppParts
);

Die Parameter

[out] ppParts

Zeiger auf eine Zeigervariable, in die die Methode die Adresse einer IPartsList-Schnittstelle schreibt, die die Liste der Teile kapselt, die unmittelbar von diesem Teil nachgelagert sind. Über diese Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist dafür verantwortlich, die Schnittstelle freizugeben, 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, enthalten mögliche Rückgabecodes, sind jedoch nicht beschränkt auf die in der folgenden Tabelle gezeigten Werte.

Bemerkungen

Eine Clientanwendung kann eine Gerätetopologie in Richtung des Audiodatenflusses durchlaufen, indem sie diese Methode in jedem Schritt der Traversal durchlaufen, um die Liste der Teile abzurufen, die unmittelbar nacheinander vom aktuellen Teil liegen.

Wenn dieser Teil keine Verknüpfungen zu nachgelagerten 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 Verbinder 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

Siehe auch

IPart-Schnittstelle

IPartsList-Schnittstelle