Compartilhar via

Método IAudioSystemEffectsPropertyStore::OpenUserPropertyStore (mmdeviceapi.h)

  • Artigo

Abre o repositório de propriedades do usuário de efeitos do sistema de áudio.

Sintaxe

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

Parâmetros

stgmAccess

O modo de acesso de armazenamento. Esse parâmetro especifica se o repositório de propriedades deve ser aberto no modo de leitura, no modo de gravação ou no modo de leitura/gravação. Defina esse parâmetro como uma das seguintes constantes STGM:

STGM_READ

STGM_WRITE

STGM_READWRITE

O método permite que um cliente em execução como administrador abra um repositório para acesso somente leitura, somente gravação ou leitura/gravação. Um cliente que não está em execução como administrador está restrito ao acesso somente leitura.

propStore

Recebe um ponteiro para um IPropertyStore que representa o repositório de propriedades do usuário.

Retornar valor

Retorna um HRESULT incluindo, mas não se limitando ao seguinte:

Valor Descrição
S_OK Êxito
E_NOTFOUND A chamada está tentando abrir um repositório de propriedades que não existe. Consulte Observações.
E_ACCESSDENIED O chamador teve acesso negado para o valor stgmAccess especificado

Comentários

Esse método só abrirá repositórios de propriedades existentes nas chaves do registro de contexto. Ele não criará uma nova chave se uma não estiver presente no arquivo INF associado. A tentativa de acessar um repositório de propriedades que ainda não existe resultará em um erro de E_NOTFOUND.

Para obter mais informações sobre as APIs de Windows 11 para APOs (Objetos de Processamento de Áudio) que podem ser enviadas com drivers de áudio, consulte APIs Windows 11 para objetos de processamento de áudio.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Build 22000
Cabeçalho mmdeviceapi.h