共用方式為

IAudioSystemEffectsPropertyStore：：OpenVolatilePropertyStore 方法 (mmdeviceapi.h)

  • 發行項

開啟音訊系統效果 volatile 屬性存放區。

語法

HRESULT OpenVolatilePropertyStore(
  DWORD          stgmAccess,
  IPropertyStore **propStore
);

參數

stgmAccess

記憶體存取模式。 此參數會指定是否要在讀取模式、寫入模式或讀取/寫入模式中開啟屬性存放區。 將此參數設定為下列其中一個 STGM 常數：

STGM_READ

STGM_WRITE

STGM_READWRITE

方法可讓以系統管理員身分執行的客戶端開啟存放區，以取得唯讀、唯讀或讀取/寫入存取權。 未以系統管理員身分執行的用戶端受限於唯讀存取。

propStore

接收代表 volatile 屬性存放區的 IPropertyStore 指標。

傳回值

傳回 HRESULT，包括但不限於下列專案：

值 描述
S_OK Success
E_NOTFOUND 呼叫嘗試開啟不存在的屬性存放區。 請參閱＜備註＞。
E_ACCESSDENIED 呼叫端拒絕存取指定的 stgmAccess 值

備註

這個方法只會開啟內容登錄機碼下的現有屬性存放區。 如果相關聯的 INF 檔案中沒有金鑰，它就不會建立新的密鑰。 嘗試存取不存在的屬性存放區會導致E_NOTFOUND錯誤。

如需音訊處理物件的 Windows 11 API (API) 可隨附音訊驅動程式的詳細資訊，請參閱音訊處理物件的 Windows 11 API。

規格需求

需求 值
最低支援的用戶端 Windows 組建 22000
標頭 mmdeviceapi.h