acmFilterChooseA-Funktion (msacm.h)

  • Artikel

Die acmFilterChoose-Funktion erstellt ein von ACM definiertes Dialogfeld, mit dem der Benutzer einen Waveform-Audiofilter auswählen kann.

Syntax

MMRESULT ACMAPI acmFilterChooseA(
  LPACMFILTERCHOOSEA pafltrc
);

Parameter

pafltrc

Zeiger auf eine ACMFILTERCHOOSE-Struktur , die Informationen enthält, die zum Initialisieren des Dialogfelds verwendet werden. Wenn acmFilterChoose zurückgibt, enthält diese Struktur Informationen zur Filterauswahl des Benutzers.

Das pwfltr-Element dieser Struktur muss einen gültigen Zeiger auf einen Speicherspeicherort enthalten, der die zurückgegebene Filterheaderstruktur enthält. Das cbwfltr-Element muss mit der Größe dieses Speicherpuffers in Bytes ausgefüllt werden.

Rückgabewert

Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist. Mögliche Fehlerwerte sind:

Rückgabecode Beschreibung
ACMERR_CANCELED
 Der Benutzer hat im Menü System die Schaltfläche Abbrechen oder den Befehl Schließen ausgewählt, um das Dialogfeld zu schließen.
ACMERR_NOTPOSSIBLE
 Der durch die [ACMFILTERCHOOSE](./nf-msacm-acmfilterchoose.md)-Struktur identifizierte Puffer ist zu klein, um den ausgewählten Filter zu enthalten.
MMSYSERR_INVALFLAG
 Mindestens ein Flag ist ungültig.
MMSYSERR_INVALHANDLE
 Das angegebene Handle ist ungültig.
MMSYSERR_INVALPARAM
 Mindestens ein Parameter ist ungültig.
MMSYSERR_NODRIVER
 Ein geeigneter Treiber ist nicht verfügbar, um gültige Filterauswahlen bereitzustellen.

Hinweise

Hinweis

Der msacm.h-Header definiert ACMFILTERCHOOSE als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile msacm.h
Bibliothek Msacm32.lib
DLL Msacm32.dll

Weitere Informationen

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager