Metodo IAudioSystemEffectsPropertyStore::OpenUserPropertyStore (mmdeviceapi.h)

Apre l'archivio delle proprietà utente degli effetti del sistema audio.

Sintassi

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

Parametri

stgmAccess

Modalità di accesso all'archiviazione. Questo parametro specifica se aprire l'archivio delle proprietà in modalità lettura, modalità scrittura o modalità lettura/scrittura. Impostare questo parametro su una delle costanti STGM seguenti:

STGM_READ

STGM_WRITE

STGM_READWRITE

Il metodo consente a un client in esecuzione come amministratore di aprire un archivio per l'accesso in sola lettura, di sola scrittura o di lettura/scrittura. Un client che non è in esecuzione come amministratore è limitato all'accesso di sola lettura.

propStore

Riceve un puntatore a un oggetto IPropertyStore che rappresenta l'archivio delle proprietà utente.

Valore restituito

Restituisce un valore HRESULT, incluso, ma non limitato al seguente:

Valore	Descrizione
S_OK	Operazione riuscita
E_NOTFOUND	La chiamata sta tentando di aprire un archivio di proprietà che non esiste. Vedere la sezione Osservazioni.
E_ACCESSDENIED	Accesso negato al chiamante per il valore stgmAccess specificato

Commenti

Questo metodo aprirà solo gli archivi di proprietà esistenti nelle chiavi del Registro di sistema del contesto. Non creerà una nuova chiave se non ne è presente uno nel file INF associato. Se si tenta di accedere a un archivio di proprietà che non esiste già, verrà generato un errore di E_NOTFOUND.

Per altre informazioni sulle API di Windows 11 per le API (Audio Processing Objects) che possono essere fornite con driver audio, vedere API Windows 11 per oggetti di elaborazione audio.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Build 22000
Intestazione	mmdeviceapi.h