acmFilterEnumW-Funktion (msacm.h)

Artikel
11/20/2024

Die acmFilterEnum-Funktion listet Waveform-Audiofilter auf, die für ein bestimmtes Filtertag von einem ACM-Treiber verfügbar sind. Diese Funktion wird weiterhin aufgezählt, bis keine geeigneten Filter für das Filtertag vorhanden sind, oder die Rückruffunktion gibt FALSE-zurück.

Syntax

MMRESULT ACMAPI acmFilterEnumW(
  HACMDRIVER          had,
  LPACMFILTERDETAILSW pafd,
  ACMFILTERENUMCBW    fnCallback,
  DWORD_PTR           dwInstance,
  DWORD               fdwEnum
);

Parameter

had

Behandeln Sie den ACM-Treiber, um Details des Waveform-Audiofilters abzufragen. Wenn dieser Parameter NULL-ist, verwendet das ACM die Details des ersten geeigneten ACM-Treibers.

pafd

Zeiger auf die ACMFILTERDETAILS Struktur, die die Filterdetails enthält, wenn sie an die durch fnCallbackangegebene Funktion übergeben wird. Wenn Ihre Anwendung acmFilterEnumaufruft, müssen die cbStruct, pwfltrund cbwfltr Member dieser Struktur initialisiert werden. Das dwFilterTag Member muss auch für WAVE_FILTER_UNKNOWN oder ein gültiges Filtertag initialisiert werden.

fnCallback

Prozedurinstanzadresse 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 Aufzählen der Filter für ein bestimmtes Filtertag. Die folgenden Werte sind definiert.

[ACMFILTERDETAILS](./nf-msacm-acmfilterdetails.md) Struktur ist gültig. Der Enumerator enumeriert nur einen Filter, der diesem Attribut entspricht. Das dwFilterTag Mitglied der ACMFILTERDETAILS Struktur muss dem dwFilterTag- Member der WAVEFILTER- Struktur entsprechen.

Wert	Bedeutung
ACM_FILTERENUMF_DWFILTERTAG

Rückgabewert

Gibt Null zurück, wenn dies erfolgreich ist oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:

Rückgabecode	Beschreibung
ACMERR_NOTPOSSIBLE	Die Details für den Filter können nicht zurückgegeben werden.
MMSYSERR_INVALFLAG	Mindestens ein Kennzeichen ist ungültig.
MMSYSERR_INVALHANDLE	Der angegebene Handle ist ungültig.
MMSYSERR_INVALPARAM	Mindestens ein Parameter ist ungültig.

Bemerkungen

Die acmFilterEnum-Funktion 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, acmDriverRemoveund acmDriverPriority.

Anmerkung

Der msacm.h-Header definiert acmFilterEnum 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

Siehe auch

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager

Freigeben über