共用方式為


IConnector::GetDeviceIdConnectedTo 方法 (devicetopology.h)

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

語法

HRESULT GetDeviceIdConnectedTo(
  [out] LPWSTR *ppwstrDeviceId
);

參數

[out] ppwstrDeviceId

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

傳回值

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

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

備註

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

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

規格需求

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

另請參閱

IConnector 介面

IMMDeviceEnumerator::GetDevice