(devicetopology.h) 的 IDeviceTopology 介面

IDeviceTopology介面可讓您存取音訊裝置的拓撲。 音訊 配接 器裝置的拓撲包含資料路徑，這些路徑會導向音訊端點裝置，以及沿著路徑的控制點。 音訊 端點 裝置也有拓撲，但它很簡單，如 裝置拓撲中所述。 用戶端會遵循下列步驟，取得音訊端點裝置之 IDeviceTopology 介面的參考：

1. 藉由使用 IMMDevice 介面中所述的其中一種技術，取得音訊端點裝置 之 IMMDevice 介面的參考。
2. 呼叫 IMMDevice：：Activate 方法，並將參數 refiid 設定為 REFIID IID_IDeviceTopology。

取得音訊端點裝置的 IDeviceTopology 介面之後，應用程式可以探索端點裝置所連接的音訊配接器裝置拓撲。

如需使用 IDeviceTopology 介面的程式碼範例，請參閱裝置拓撲中的 GetHardwareDeviceTopology 和 SelectCaptureDevice 函 式的實作。

繼承

IDeviceTopology介面繼承自IUnknown介面。 IDeviceTopology 也有下列類型的成員：

方法

IDeviceTopology介面具有這些方法。

IDeviceTopology：：GetConnector GetConnector 方法會取得連接器編號所指定的連接器。
IDeviceTopology：：GetConnectorCount GetConnectorCount 方法會取得裝置拓撲物件中的連接器數目。
IDeviceTopology：：GetDeviceId GetDeviceId 方法會取得裝置的裝置識別碼，該裝置由裝置拓撲物件表示。
IDeviceTopology：：GetPartById GetPartById 方法會取得其本機識別碼所識別的元件。
IDeviceTopology：：GetSignalPath 如果路徑存在，GetSignalPath 方法會取得訊號路徑中連結兩個部分的元件清單。
IDeviceTopology：：GetSubunit GetSubunit 方法會取得子單位編號所指定的子單位。
IDeviceTopology：：GetSubunitCount GetSubunitCount 方法會取得裝置拓撲中的子單位數目。

需求

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

另請參閱

核心音訊介面

DeviceTopology API

IMMDevice：：Activate