Share via

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
 參數 pwstrId 為 Null。

備註

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

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

需求

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

另請參閱

IMMDevice 介面

IMMDeviceEnumerator：：GetDevice