acmFilterChooseW-Funktion (msacm.h)
Die acmFilterChoose--Funktion erstellt ein ACM-definiertes Dialogfeld, mit dem der Benutzer einen Waveform-Audiofilter auswählen kann.
Syntax
MMRESULT ACMAPI acmFilterChooseW(
LPACMFILTERCHOOSEW pafltrc
);
Parameter
pafltrc
Zeigen Sie 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 Mitglied dieser Struktur muss einen gültigen Zeiger auf einen Speicherspeicherort enthalten, der die zurückgegebene Filterkopfstruktur enthält. Das cbwfltr Member muss mit der Größe dieses Speicherpuffers in Byte ausgefüllt werden.
Rückgabewert
Gibt MMSYSERR_NOERROR zurück, wenn dies erfolgreich ist oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Benutzer hat die Schaltfläche "Abbrechen" oder den Befehl "Schließen" im Menü "System" ausgewählt, um das Dialogfeld zu schließen. |
|
Der durch die [ACMFILTERCHOOSE](./nf-msacm-acmfilterchoose.md)-Struktur identifizierte Puffer ist zu klein, um den ausgewählten Filter zu enthalten. |
|
Mindestens ein Kennzeichen ist ungültig. |
|
Der angegebene Handle ist ungültig. |
|
Mindestens ein Parameter ist ungültig. |
|
Ein geeigneter Treiber ist nicht verfügbar, um gültige Filterauswahlen bereitzustellen. |
Bemerkungen
Anmerkung
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 Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | msacm.h |
| Library | Msacm32.lib |
| DLL- | Msacm32.dll |