acmFilterTagEnum-Funktion (msacm.h)

  • Artikel

Die Funktion acmFilterTagEnum listet Waveform-Audiofiltertags auf, die über einen ACM-Treiber verfügbar sind. Diese Funktion wird weiterhin aufgelistet, bis keine geeigneten Filtertags vorhanden sind oder die Rückruffunktion FALSE zurückgibt.

Syntax

MMRESULT ACMAPI acmFilterTagEnum(
  HACMDRIVER            had,
  LPACMFILTERTAGDETAILS paftd,
  ACMFILTERTAGENUMCB    fnCallback,
  DWORD_PTR             dwInstance,
  DWORD                 fdwEnum
);

Parameter

had

Verarbeiten Sie den ACM-Treiber, um die Details des Waveform-Audiofiltertags abzufragen. Wenn dieser Parameter NULL ist, verwendet der ACM die Details des ersten geeigneten ACM-Treibers.

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 das cbStruct-Element dieser Struktur initialisiert werden.

fnCallback

Prozedur instance Adresse der anwendungsdefinierte Rückruffunktion.

dwInstance

Ein anwendungsdefinierter 64-Bit- (DWORD_PTR) oder 32-Bit-Wert (DWORD), der zusammen mit ACM-Filtertagdetails an die Rückruffunktion übergeben wird.

fdwEnum

Reserviert; muss null sein.

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler. Mögliche Fehlerwerte sind:

Rückgabecode Beschreibung
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

Diese Funktion gibt MMSYSERR_NOERROR (null) zurück, wenn keine geeigneten ACM-Treiber installiert sind. Darüber hinaus wird die Rückruffunktion nicht aufgerufen.

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

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager