Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |