IPart：：EnumPartsIncoming 方法 (devicetopology.h)

EnumPartsIncoming 方法會取得所有傳入元件的清單，也就是位於此元件上游之數據路徑上的元件。

語法

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

參數

[out] ppParts

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

傳回值

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

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

備註

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

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

規格需求

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

另請參閱

IPart 介面

IPartsList 介面