Compartir a través de

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

  • Artículo

Abre el almacén de propiedades predeterminado de efectos del sistema de audio.

Sintaxis

HRESULT OpenDefaultPropertyStore(
  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 predeterminado.

Valor devuelto

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

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

Comentarios

Este método solo abrirá los 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 api de Windows 11 para objetos de procesamiento de audio.

Requisitos

   
Cliente mínimo compatible Compilación 22000 de Windows
Encabezado mmdeviceapi.h