共用方式為

IDeviceTopology：：GetDeviceId 方法 (devicetopology.h)

  • 發行項

GetDeviceId 方法會取得裝置的裝置標識碼，該裝置是由裝置拓撲物件表示。

語法

HRESULT GetDeviceId(
  [out] LPWSTR *ppwstrDeviceId
);

參數

[out] ppwstrDeviceId

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

傳回值

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

傳回碼 Description
D_POINTER
 指標 ppwstrDeviceId 為 NULL。
E_OUTOFMEMORY
 記憶體不足。

備註

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

如需使用 GetDeviceId 方法的程式代碼範例，請參閱 使用 IKsControl 介面存取音訊屬性。

規格需求

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

另請參閱

IDeviceTopology 介面

IMMDeviceEnumerator：：GetDevice