acmFormatTagEnumA-Funktion (msacm.h)

Artikel
03/04/2024

Die Funktion acmFormatTagEnum listet Tags im Waveform-Audio-Format auf, die über einen ACM-Treiber verfügbar sind. Diese Funktion setzt die Aufzählung fort, bis keine geeigneten Formattags vorhanden sind oder die Rückruffunktion FALSE zurückgibt.

Syntax

MMRESULT ACMAPI acmFormatTagEnumA(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSA paftd,
  ACMFORMATTAGENUMCBA    fnCallback,
  DWORD_PTR              dwInstance,
  DWORD                  fdwEnum
);

Parameter

had

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

paftd

Zeiger auf die ACMFORMATTAGDETAILS-Struktur , die die Formattagdetails empfangen soll, die an die in fnCallback angegebene Funktion übergeben werden. Diese Struktur muss über den cbStruct-Member der ACMFORMATTAGDETAILS-Struktur initialisiert sein.

fnCallback

Prozedur instance Adresse der anwendungsdefinierten Rückruffunktion.

dwInstance

Ein anwendungsdefinierter 64-Bit-Wert (DWORD_PTR) oder 32-Bit (DWORD), der zusammen mit den Tagdetails im ACM-Format 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
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.

Hinweis

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

Freigeben über