acmFilterChoose-Funktion (msacm.h)

  • Artikel

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

Syntax

MMRESULT ACMAPI acmFilterChoose(
  LPACMFILTERCHOOSE pafltrc
);

Parameter

pafltrc

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

Der pwfltr-Member dieser Struktur muss einen gültigen Zeiger auf einen Speicherort enthalten, der die zurückgegebene Filterheaderstruktur enthält. Der cbwfltr-Member 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]()-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.

Anforderungen

Anforderung Wert
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