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

Ouvre le magasin de propriétés volatiles des effets du système audio.

Syntaxe

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

Paramètres

stgmAccess

Mode d’accès au stockage. Ce paramètre spécifie s’il faut ouvrir le magasin de propriétés en mode lecture, en mode écriture ou en mode lecture/écriture. Définissez ce paramètre sur l’une des constantes STGM suivantes :

STGM_READ

STGM_WRITE

STGM_READWRITE

La méthode permet à un client s’exécutant en tant qu’administrateur d’ouvrir un magasin pour un accès en lecture seule, en écriture seule ou en lecture/écriture. Un client qui ne s’exécute pas en tant qu’administrateur est limité à l’accès en lecture seule.

propStore

Reçoit un pointeur vers un IPropertyStore représentant le magasin de propriétés volatiles.

Valeur retournée

Retourne un HRESULT incluant, mais sans s’y limiter, les éléments suivants :

Valeur	Description
S_OK	Succès
E_NOTFOUND	L’appel tente d’ouvrir un magasin de propriétés qui n’existe pas. Consultez la section Notes.
E_ACCESSDENIED	L’appelant s’est vu refuser l’accès pour la valeur stgmAccess spécifiée

Remarques

Cette méthode ouvre uniquement les magasins de propriétés existants sous les clés de Registre de contexte. Il ne crée pas de nouvelle clé si elle n’est pas présente dans le fichier INF associé. La tentative d’accès à un magasin de propriétés qui n’existe pas encore entraîne une erreur E_NOTFOUND.

Pour plus d’informations sur les API Windows 11 pour les objets de traitement audio (API) qui peuvent être fournis avec des pilotes audio, consultez Windows 11 API pour les objets de traitement audio.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Build 22000
En-tête	mmdeviceapi.h