acmFilterChooseW-Funktion (msacm.h)
Die acmFilterChoose-Funktion erstellt ein von ACM definiertes Dialogfeld, mit dem der Benutzer einen Waveform-Audiofilter auswählen kann.
Syntax
MMRESULT ACMAPI acmFilterChooseW(
LPACMFILTERCHOOSEW 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 |
---|---|
|
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](./nf-msacm-acmfilterchoose.md)-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. |
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für