IAudioSystemEffectsPropertyStore::Metode OpenUserPropertyStore (mmdeviceapi.h)

Artikel
08/24/2023

Membuka penyimpanan properti pengguna efek sistem audio.

Sintaks

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

Parameter

stgmAccess

Mode akses penyimpanan. Parameter ini menentukan apakah akan membuka penyimpanan properti dalam mode baca, mode tulis, atau mode baca/tulis. Atur parameter ini ke salah satu konstanta STGM berikut:

STGM_READ

STGM_WRITE

STGM_READWRITE

Metode ini memungkinkan klien yang berjalan sebagai administrator untuk membuka penyimpanan untuk akses baca-saja, tulis-saja, atau baca/tulis. Klien yang tidak berjalan sebagai administrator dibatasi untuk akses baca-saja.

propStore

Menerima penunjuk ke IPropertyStore yang mewakili penyimpanan properti pengguna.

Mengembalikan nilai

Mengembalikan HRESULT termasuk, tetapi tidak terbatas pada hal berikut:

Nilai	Deskripsi
S_OK	Berhasil
E_NOTFOUND	Panggilan mencoba membuka penyimpanan properti yang tidak ada. Lihat Keterangan.
E_ACCESSDENIED	Pemanggil ditolak akses untuk nilai stgmAccess yang ditentukan

Keterangan

Metode ini hanya akan membuka penyimpanan properti yang ada di bawah kunci registri konteks. Ini tidak akan membuat kunci baru jika tidak ada dalam file INF terkait. Mencoba mengakses penyimpanan properti yang belum ada akan mengakibatkan kesalahan E_NOTFOUND.

Untuk informasi selengkapnya tentang API Windows 11 untuk Objek Pemrosesan Audio (API) yang dapat dikirim dengan driver audio, lihat api Windows 11 untuk Objek Pemrosesan Audio.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Build 22000
Header	mmdeviceapi.h

Bagikan melalui