IPart：：EnumPartsOutgoing 方法 (devicetopology.h)

EnumPartsOutgoing 方法會擷取所有傳出元件的清單，也就是位於此部分下游數據路徑上的元件。

語法

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

參數

[out] ppParts

指標變數的指標，此方法會將 IPartsList 介面的位址寫入其中，以封裝此部分緊接在下游的元件清單。 透過這個方法，呼叫端會取得介面的計數參考。 呼叫端負責藉由呼叫介面的 Release 方法，在不再需要介面時釋出介面。 如果 EnumPartsOutgoing 呼叫失敗， *ppParts 為 NULL。

傳回值

如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括，但不限於下表所示的值。

傳回碼	Description
E_POINTER	指標 ppParts 為 NULL。
E_NOTFOUND	此元件沒有下游元件的連結。
E_OUTOFMEMORY	記憶體不足。

備註

用戶端應用程式可以在周遊中的每個步驟反覆呼叫此方法，以音訊數據流方向周遊裝置拓撲，以取得緊接在目前元件下游的元件清單。

如果這個元件沒有下游元件的連結，此方法會傳回錯誤碼E_NOTFOUND，而且不會建立元件清單， (*ppParts 為 NULL) 。 例如，如果 IPart 介面代表連接器，數據會結束裝置拓撲，則方法會傳回這個錯誤碼。

如需使用 EnumPartsOutgoing 方法的程式代碼範例，請參閱裝置拓撲中的 SelectCaptureDevice 函 式實作。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	devicetopology.h

另請參閱

IPart 介面

IPartsList 介面