IAudioSystemEffectsPropertyStore::OpenUserPropertyStore 方法 (mmdeviceapi.h)
打开音频系统效果用户属性存储。
语法
HRESULT OpenUserPropertyStore(
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错误。
有关音频处理对象Windows 11 API (音频驱动程序附带的 API) 的详细信息,请参阅音频处理对象的 Windows 11 API。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 内部版本 22000 |
标头 | mmdeviceapi.h |