共用方式為

IControlInterface：：GetName 方法 (devicetopology.h)

  • 發行項

GetName方法會取得控制項介面所封裝之音訊函式的易記名稱。

語法

HRESULT GetName(
  [out] LPWSTR *ppwstrName
);

參數

[out] ppwstrName

字串指標的指標，此方法會寫入包含易記名稱之 Null 終止寬字元字串的位址。 方法會配置字串的儲存體。 呼叫端會藉由呼叫 CoTaskMemFree 函式，負責釋出不再需要的儲存體。 如果 GetName 呼叫失敗， *ppwstrName 為 Null。 如需 CoTaskMemFree的相關資訊，請參閱 Windows SDK 檔。

傳回值

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

傳回碼 描述
E_POINTER
 指標 ppwstrName 為 Null。
E_OUTOFMEMORY
 記憶體不足。

備註

作為易記名稱的範例，具有 IAudioPeakMeter 介面的子單位可能有易記名稱 「尖峰計量」。

需求

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

另請參閱

IAudioPeakMeter 介面

IControlInterface 介面