Compartir a través de

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

  • Artículo

Abre el almacén de propiedades volátiles de efectos del sistema de audio.

Sintaxis

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

Parámetros

stgmAccess

Modo de acceso de almacenamiento. Este parámetro especifica si se debe abrir el almacén de propiedades en modo de lectura, modo de escritura o modo de lectura y escritura. Establezca este parámetro en una de las siguientes constantes STGM:

STGM_READ

STGM_WRITE

STGM_READWRITE

El método permite que un cliente que se ejecute como administrador abra un almacén para acceso de solo lectura, de solo escritura o de lectura y escritura. Un cliente que no se ejecuta como administrador está restringido al acceso de solo lectura.

propStore

Recibe un puntero a un IPropertyStore que representa el almacén de propiedades volátiles.

Valor devuelto

Devuelve un VALOR HRESULT, incluido, pero no limitado a lo siguiente:

Valor Descripción
S_OK Correcto
E_NOTFOUND La llamada intenta abrir un almacén de propiedades que no existe. Vea la sección Comentarios.
E_ACCESSDENIED Se denegó el acceso del autor de la llamada para el valor stgmAccess especificado.

Comentarios

Este método solo abrirá almacenes de propiedades existentes en las claves del Registro de contexto. No creará una nueva clave si no está presente en el archivo INF asociado. Si se intenta acceder a un almacén de propiedades que aún no existe, se producirá un error de E_NOTFOUND.

Para obtener más información sobre las API de Windows 11 para los objetos de procesamiento de audio (API) que se pueden enviar con controladores de audio, consulte Windows 11 API para objetos de procesamiento de audio.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Build 22000
Encabezado mmdeviceapi.h