acmFilterEnumA-Funktion (msacm.h)
Die Funktion acmFilterEnum listet Waveform-Audiofilter auf, die für ein bestimmtes Filtertag aus einem ACM-Treiber verfügbar sind. Diese Funktion listet weiter auf, bis keine geeigneten Filter für das Filtertag vorhanden sind oder die Rückruffunktion FALSE zurückgibt.
Syntax
MMRESULT ACMAPI acmFilterEnumA(
HACMDRIVER had,
LPACMFILTERDETAILSA pafd,
ACMFILTERENUMCBA fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
Parameter
had
Verarbeiten Sie den ACM-Treiber, um details des Waveform-Audiofilters abzufragen. Wenn dieser Parameter NULL ist, verwendet der ACM die Details des ersten geeigneten ACM-Treibers.
pafd
Zeiger auf die ACMFILTERDETAILS-Struktur , die die Filterdetails enthält, wenn sie an die von fnCallback angegebene Funktion übergeben wird. Wenn Ihre Anwendung acmFilterEnum aufruft, müssen die Elemente cbStruct, pwfltr und cbwfltr dieser Struktur initialisiert werden. Das dwFilterTag-Element muss auch für WAVE_FILTER_UNKNOWN oder ein gültiges Filtertag initialisiert werden.
fnCallback
Prozedur-instance Adresse der anwendungsdefinierte Rückruffunktion.
dwInstance
Ein anwendungsdefinierter 32-Bit-Wert (DWORD), 64-Bit (DWORD_PTR), der zusammen mit ACM-Filterdetails an die Rückruffunktion übergeben wird.
fdwEnum
Flags zum Auflisten der Filter für ein bestimmtes Filtertag. Die folgenden Werte werden definiert.
[ACMFILTERDETAILS] (./nf-msacm-acmfilterdetails.md)-Struktur ist gültig. Der Enumerator listet nur einen Filter auf, der diesem Attribut entspricht. Das dwFilterTag-Element der ACMFILTERDETAILS-Struktur muss gleich dem dwFilterTag-Member der WAVEFILTER-Struktur sein.Wert | Bedeutung |
---|---|
ACM_FILTERENUMF_DWFILTERTAG |
Rückgabewert
Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler. Mögliche Fehlerwerte sind:
Rückgabecode | Beschreibung |
---|---|
|
Die Details für den Filter können nicht zurückgegeben werden. |
|
Mindestens ein Flag ist ungültig. |
|
Das angegebene Handle ist ungültig. |
|
Mindestens ein Parameter ist ungültig. |
Hinweise
Die Funktion acmFilterEnum gibt MMSYSERR_NOERROR (null) zurück, wenn keine geeigneten ACM-Treiber installiert sind. Darüber hinaus wird die Rückruffunktion nicht aufgerufen.
Die folgenden Funktionen sollten nicht innerhalb der Rückruffunktion aufgerufen werden: acmDriverAdd, acmDriverRemove und acmDriverPriority.
Hinweis
Der msacm.h-Header definiert acmFilterEnum als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
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
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