Share via

Метод 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.

Дополнительные сведения об API Windows 11 для объектов обработки звука (APOs), которые могут поставляться с аудиодрайверами, см. в статье Windows 11 API для объектов обработки звука.

Требования

Требование Значение
Минимальная версия клиента Сборка Windows 22000
Верхняя часть mmdeviceapi.h