acmFormatTagEnum-Funktion (msacm.h)
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 acmFormatTagEnum(
HACMDRIVER had,
LPACMFORMATTAGDETAILS paftd,
ACMFORMATTAGENUMCB 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 |
|---|---|
|
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.
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 |