acmFilterChoose-Funktion (msacm.h)
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 |
|---|---|
|
Der Benutzer hat im Menü System die Schaltfläche Abbrechen oder den Befehl Schließen ausgewählt, um das Dialogfeld zu schließen. |
|
Der durch die [ACMFILTERCHOOSE]()-Struktur identifizierte Puffer ist zu klein, um den ausgewählten Filter zu enthalten. |
|
Mindestens ein Flag ist ungültig. |
|
Das angegebene Handle ist ungültig. |
|
Mindestens ein Parameter ist ungültig. |
|
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 |