acmFormatTagDetailsW-Funktion (msacm.h)

Artikel
11/20/2024

Die acmFormatTagDetails-Funktion fragt das ACM nach Details zu einem bestimmten Waveform-Audioformattag ab.

Syntax

MMRESULT ACMAPI acmFormatTagDetailsW(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSW paftd,
  DWORD                  fdwDetails
);

Parameter

had

Behandeln Sie den ACM-Treiber, um Die Details des Waveform-Audioformattags abzufragen. Wenn dieser Parameter NULL-ist, verwendet das ACM die Details des ersten geeigneten ACM-Treibers. Eine Anwendung muss bei Verwendung des ACM_FORMATTAGDETAILSF_INDEX Abfragetyps einen gültigen Handle- oder Treiberbezeichner angeben. Treiberbezeichner für deaktivierte Treiber sind nicht zulässig.

paftd

Zeigen Sie auf die ACMFORMATTAGDETAILS Struktur, die die Formattagdetails empfängt.

fdwDetails

Flags zum Abrufen der Details. Die folgenden Werte sind definiert.

[ACMFORMATTAGDETAILS](./nf-msacm-acmformattagdetails.md) Struktur. Die Formattagdetails werden in der Struktur zurückgegeben, auf die von paftdverwiesen wird. Wenn eine Anwendung ein ACM-Treiberhandle für angibt, werden Details zum Formattag für diesen Treiber zurückgegeben. Wenn eine Anwendung NULL- für angibt, findet die ACM den ersten zulässigen Treiber, um die Details zurückzugeben. [ACMDRIVERDETAILS](./nf-msacm-acmdriverdetails.md) Struktur für einen ACM-Treiber. Eine Anwendung muss ein Treiberhandle für beim Abrufen von Formattagdetails mit dieser Kennzeichnung angeben. [ACMFORMATTAGDETAILS](./nf-msacm-acmformattagdetails.md) Struktur muss entweder WAVE_FORMAT_UNKNOWN oder das Formattag sein, um die größte Größe zu finden. Wenn eine Anwendung ein ACM-Treiberhandle für enthält, werden Details zum größten Formattag für diesen Treiber zurückgegeben. Wenn eine Anwendung NULL- für angibt, findet die ACM einen akzeptablen Treiber mit dem größten Formattag, das zum Zurückgeben der Details angefordert wurde.

Wert	Bedeutung
ACM_FORMATTAGDETAILSF_FORMATTAG
ACM_FORMATTAGDETAILSF_INDEX
ACM_FORMATTAGDETAILSF_LARGESTSIZE

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 angeforderten Details sind nicht verfügbar.
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

Anmerkung

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