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

Article
03/04/2024

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

Syntaxe

HRESULT OpenUserPropertyStore(
  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 n’est pas exécuté 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 utilisateur.

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’accès à la valeur stgmAccess spécifiée a été refusé à l’appelant

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é. Toute tentative d’accès à un magasin de propriétés qui n’existe pas déjà génère 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

Partager via