IMMDevice：：GetId 方法 (mmdeviceapi.h)
GetId方法會擷取可識別音訊端點裝置的端點識別碼字串。
語法
HRESULT GetId(
[out] LPWSTR *ppstrId
);
參數
[out] ppstrId
指標變數的指標，方法會寫入包含端點裝置識別碼之 Null 終止寬字元字串的位址。 方法會配置字串的儲存體。 呼叫端會藉由呼叫 CoTaskMemFree 函式，負責釋出不再需要的儲存體。 如果 GetId 呼叫失敗， *ppstrId 為 Null。 如需 CoTaskMemFree的相關資訊，請參閱 Windows SDK 檔。
傳回值
如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括，但不限於下表所示的值。
| 傳回碼 | 描述 |
|---|---|
|
記憶體不足。 |
|
參數 pwstrId 為 Null。 |
備註
從這個方法取得的端點識別碼字串會識別 由 IMMDevice 介面實例表示的音訊端點裝置。 用戶端可以使用端點識別碼字串，在稍後或呼叫 IMMDeviceEnumerator：：GetDevice 方法來建立音訊端點裝置的實例。 用戶端應該將端點識別碼字串的內容視為不透明。 也就是說，用戶端 不應該 嘗試剖析字串的內容，以取得裝置的相關資訊。 原因是字串格式未定義，而且可能會從 MMDevice API 系統模組的其中一個實作變更為下一個。
如需呼叫 GetId 方法的程式碼範例，請參閱下列主題：
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | mmdeviceapi.h |