IAudioSystemEffectsPropertyStore::OpenDefaultPropertyStore-Methode (mmdeviceapi.h)

Artikel
08/24/2023

Öffnet den Standardeigenschaftenspeicher für Audiosystemeffekte.

Syntax

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

Parameter

stgmAccess

Der Speicherzugriffsmodus. Dieser Parameter gibt an, ob der Eigenschaftenspeicher im Lesemodus, im Schreibmodus oder im Lese-/Schreibmodus geöffnet werden soll. Legen Sie diesen Parameter auf eine der folgenden STGM-Konstanten fest:

STGM_READ

STGM_WRITE

STGM_READWRITE

Die -Methode ermöglicht es einem Client, der als Administrator ausgeführt wird, einen Speicher für schreibgeschützten, schreibgeschützten oder Lese-/Schreibzugriff zu öffnen. Ein Client, der nicht als Administrator ausgeführt wird, ist auf schreibgeschützten Zugriff beschränkt.

propStore

Empfängt einen Zeiger auf einen IPropertyStore , der den Standardeigenschaftenspeicher darstellt.

Rückgabewert

Gibt ein HRESULT zurück, einschließlich, aber nicht beschränkt auf Folgendes:

Wert	BESCHREIBUNG
S_OK	Erfolg
E_NOTFOUND	Der Aufruf versucht, einen Eigenschaftenspeicher zu öffnen, der nicht vorhanden ist. Siehe Hinweise.
E_ACCESSDENIED	Dem Aufrufer wurde der Zugriff für den angegebenen stgmAccess-Wert verweigert.

Hinweise

Diese Methode öffnet nur vorhandene Eigenschaftenspeicher unter den Kontextregistrierungsschlüsseln. Es wird kein neuer Schlüssel erstellt, wenn er in der zugeordneten INF-Datei nicht vorhanden ist. Der Versuch, auf einen Eigenschaftenspeicher zuzugreifen, der noch nicht vorhanden ist, führt zu einem E_NOTFOUND Fehler.

Weitere Informationen zu den Windows 11-APIs für die Audioverarbeitungsobjekte (Audio Processing Objects, APOs), die mit Audiotreibern ausgeliefert werden können, finden Sie unter Windows 11 APIs für Audioverarbeitungsobjekte.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Build 22000
Kopfzeile	mmdeviceapi.h

Freigeben über