IAudioSystemEffectsPropertyStore::OpenVolatilePropertyStore 方法 (mmdeviceapi.h)

打开音频系统效果易失性属性存储。

语法

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

参数

stgmAccess

存储访问模式。 此参数指定是在读取模式、写入模式还是读/写模式下打开属性存储。 将此参数设置为以下 STGM 常量之一:

STGM_READ

STGM_WRITE

STGM_READWRITE

方法允许以管理员身份运行的客户端打开存储区,以便进行只读、只写或读/写访问。 未以管理员身份运行的客户端被限制为只读访问权限。

propStore

接收指向表示可变属性 存储的 IPropertyStore 的指针。

返回值

返回 HRESULT,包括但不限于以下内容:

说明
S_OK 成功
E_NOTFOUND 调用尝试打开不存在的属性存储。 请参阅“备注”。
E_ACCESSDENIED 拒绝调用方访问指定的 stgmAccess

注解

此方法将仅打开上下文注册表项下的现有属性存储区。 如果关联的 INF 文件中不存在新密钥,则不会创建新密钥。 尝试访问尚不存在的属性存储将导致E_NOTFOUND错误。

有关音频驱动程序随附的音频处理对象 (API) 的Windows 11 API 的详细信息,请参阅音频处理对象的Windows 11 API

要求

要求
最低受支持的客户端 Windows 内部版本 22000
标头 mmdeviceapi.h