IConnector：：GetDeviceIdConnectedTo 方法 (devicetopology.h)

GetDeviceIdConnectedTo 方法會取得音訊裝置的裝置識別碼，如果有的話，此連接器會連線到該裝置。

語法

HRESULT GetDeviceIdConnectedTo(
  [out] LPWSTR *ppwstrDeviceId
);

參數

[out] ppwstrDeviceId

字串指標的指標的指標，此方法會將包含已連線裝置之裝置標識碼的 Null 終止寬字元字串位址寫入其中。 方法會配置字串的記憶體。 呼叫端會藉由呼叫 CoTaskMemFree 函式，負責釋放不再需要的記憶體。 如果 GetDeviceIdConnectedTo 呼叫失敗， *ppwstrDeviceId 為 NULL。 如需 CoTaskMemFree 的相關信息，請參閱 Windows SDK 檔。

傳回值

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

傳回碼	Description
E_POINTER	指標 ppwstrDeviceId 為 NULL。
E_NOTFOUND	此連接器未連線，或連線的另一端不是另一個裝置拓撲 (，例如Software_IO連線) 。
E_MEMORY	記憶體不足。

備註

從這個方法取得的裝置標識碼可作為 IMMDeviceEnumerator：：GetDevice 方法的輸入參數。

這個方法的功能相當於下列一系列的方法呼叫，但更有效率：

• 呼叫 IConnector：：GetConnectedTo 方法，以取得 「to」 連接器的 IConnector 介面。
• 呼叫 IConnector：：QueryInterface 方法 (參數 iid 設為 REFIID IID_IPart) ，以取得 “to” 連接器的 IPart 介面。
• 呼叫 IPart：：GetTopologyObject 方法來取得 “to” 裝置的 IDeviceTopology 介面， (包含 “to” 連接器的裝置) 。
• 呼叫 IDeviceTopology：：GetDeviceId 方法，以取得「到」裝置的裝置標識碼。

規格需求

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

另請參閱

IConnector 介面

IMMDeviceEnumerator：：GetDevice