IPart::EnumPartsOutgoing-Methode (devicetopology.h)
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 |
|---|---|
|
Zeiger ppParts ist NULL. |
|
Dieser Teil enthält keine Links zu nachgelagerten Teilen. |
|
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 |