acmFilterEnumW-Funktion (msacm.h)

  • Artikel

Die Funktion acmFilterEnum listet Waveform-Audiofilter auf, die für ein bestimmtes Filtertag von einem ACM-Treiber verfügbar sind. Diese Funktion setzt die Enumeration fort, bis keine geeigneteren Filter für das Filtertag vorhanden sind oder die Rückruffunktion FALSE zurückgibt.

Syntax

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

Parameter

had

Handle an den ACM-Treiber, um Details des Waveform-Audiofilters abzufragen. Wenn dieser Parameter NULL ist, verwendet der ACM die Details aus dem ersten geeigneten ACM-Treiber.

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. Der dwFilterTag-Member muss auch für WAVE_FILTER_UNKNOWN oder ein gültiges Filtertag initialisiert werden.

fnCallback

Prozedur-instance Adresse der anwendungsdefinierten 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 werden definiert.

[ACMFILTERDETAILS] (./nf-msacm-acmfilterdetails.md)-Struktur ist gültig. Der Enumerator listet nur einen Filter auf, der diesem Attribut entspricht. Der dwFilterTag-Member der ACMFILTERDETAILS-Struktur muss gleich dem dwFilterTag-Member der WAVEFILTER-Struktur sein.
Wert Bedeutung
ACM_FILTERENUMF_DWFILTERTAG

Rückgabewert

Gibt null zurück, wenn erfolgreich 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 Flag ist ungültig.
MMSYSERR_INVALHANDLE
 Das angegebene Handle ist ungültig.
MMSYSERR_INVALPARAM
 Mindestens ein Parameter ist ungültig.

Hinweise

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, acmDriverRemove und acmDriverPriority.

Hinweis

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

   
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

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager