共用方式為


IMMDevice::GetId 方法 (mmdeviceapi.h)

GetId方法會擷取可識別音訊端點裝置的端點識別碼字串

語法

HRESULT GetId(
  [out] LPWSTR *ppstrId
);

參數

[out] ppstrId

指標變數的指標,方法會寫入包含端點裝置識別碼之 Null 終止寬字元字串的位址。 方法會配置字串的儲存體。 呼叫端會藉由呼叫 CoTaskMemFree 函式,負責釋出不再需要的儲存體。 如果 GetId 呼叫失敗, *ppstrId 為 Null。 如需 CoTaskMemFree的相關資訊,請參閱 Windows SDK 檔。

傳回值

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

傳回碼 描述
E_OUTOFMEMORY
記憶體不足。
E_POINTER
參數 pwstrIdNull

備註

從這個方法取得的端點識別碼字串會識別 由 IMMDevice 介面實例表示的音訊端點裝置。 用戶端可以使用端點識別碼字串,在稍後或呼叫 IMMDeviceEnumerator::GetDevice 方法來建立音訊端點裝置的實例。 用戶端應該將端點識別碼字串的內容視為不透明。 也就是說,用戶端 不應該 嘗試剖析字串的內容,以取得裝置的相關資訊。 原因是字串格式未定義,而且可能會從 MMDevice API 系統模組的其中一個實作變更為下一個。

如需呼叫 GetId 方法的程式碼範例,請參閱下列主題:

需求

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

另請參閱

IMMDevice 介面

IMMDeviceEnumerator::GetDevice