acmFilterTagEnumA-Funktion (msacm.h)
Die Funktion acmFilterTagEnum listet Waveform-Audio-Filtertags auf, die über einen ACM-Treiber verfügbar sind. Diese Funktion setzt die Aufzählung fort, bis keine geeigneten Filtertags vorhanden sind oder die Rückruffunktion FALSE zurückgibt.
Syntax
MMRESULT ACMAPI acmFilterTagEnumA(
HACMDRIVER had,
LPACMFILTERTAGDETAILSA paftd,
ACMFILTERTAGENUMCBA fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
Parameter
had
Handle an den ACM-Treiber, um Details des Waveform-Audio-Filtertags abzufragen. Wenn dieser Parameter NULL ist, verwendet der ACM die Details aus dem ersten geeigneten ACM-Treiber.
paftd
Zeiger auf die ACMFILTERTAGDETAILS-Struktur , die die Details des Filtertags enthält, wenn sie an die fnCallback-Funktion übergeben wird. Wenn Ihre Anwendung acmFilterTagEnum aufruft, muss der cbStruct-Member dieser Struktur initialisiert werden.
fnCallback
Prozedur instance Adresse der anwendungsdefinierten Rückruffunktion.
dwInstance
Ein anwendungsdefinierter 64-Bit- (DWORD_PTR) oder 32-Bit-Wert (DWORD), der zusammen mit details des ACM-Filtertags an die Rückruffunktion übergeben wird.
fdwEnum
Reserviert; muss null sein.
Rückgabewert
Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:
Rückgabecode | Beschreibung |
---|---|
|
Mindestens ein Flag ist ungültig. |
|
Das angegebene Handle ist ungültig. |
|
Mindestens ein Parameter ist ungültig. |
Hinweise
Diese Funktion gibt MMSYSERR_NOERROR (null) zurück, wenn keine geeigneten ACM-Treiber installiert sind. Darüber hinaus wird die Rückruffunktion nicht aufgerufen.
Hinweis
Der msacm.h-Header definiert acmFilterTagEnum 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
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