acmFormatDetailsA-Funktion (msacm.h)

Artikel
11/20/2024

Die acmFormatDetails-Funktion fragt die ACM nach Formatdetails für ein bestimmtes Waveform-Audioformattag ab.

Syntax

MMRESULT ACMAPI acmFormatDetailsA(
  HACMDRIVER          had,
  LPACMFORMATDETAILSA pafd,
  DWORD               fdwDetails
);

Parameter

had

Behandeln Sie den ACM-Treiber, um Details des Waveform-Audioformats für ein Formattag abzufragen. Wenn dieser Parameter NULL-ist, verwendet das ACM die Details des ersten geeigneten ACM-Treibers.

pafd

Zeigen Sie auf eine ACMFORMATDETAILS- Struktur, um die Formatdetails für das angegebene Formattag zu enthalten.

fdwDetails

Flags zum Abrufen der Details des Waveform-Audio-Formats. Die folgenden Werte sind definiert.

[ACMFORMATDETAILS](./nf-msacm-acmformatdetails.md) Struktur wurde angegeben, und die verbleibenden Details sollten zurückgegeben werden. Das dwFormatTag Member der ACMFORMATDETAILS- Struktur muss auf dasselbe Formattag initialisiert werden wie pwfx-. Dieser Abfragetyp kann verwendet werden, um eine Zeichenfolgenbeschreibung einer beliebigen Formatstruktur abzurufen. Wenn eine Anwendung ein ACM-Treiberhandle für angibt, werden Details zum Format 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.

Wert	Bedeutung
ACM_FORMATDETAILSF_FORMAT
ACM_FORMATDETAILSF_INDEX	Ein Formatindex für das Formattag wurde im dwFormatIndex Member der ACMFORMATDETAILS Struktur angegeben. Die Formatdetails werden in der struktur zurückgegeben, die von pafddefiniert wird. Der Index reicht von 0 bis 1 kleiner als die cStandardFormats Member, das in der ACMFORMATTAGDETAILS Struktur für ein Formattag zurückgegeben wird. Eine Anwendung muss ein Treiberhandle für beim Abrufen von Formatdetails mit dieser Kennzeichnung haben. Informationen dazu, welche Member vor dem Aufrufen dieser Funktion initialisiert werden sollen, finden Sie in der ACMFORMATDETAILS Struktur.

Wert

Bedeutung

ACM_FORMATDETAILSF_FORMAT

ACM_FORMATDETAILSF_INDEX

Ein Formatindex für das Formattag wurde im dwFormatIndex Member der ACMFORMATDETAILS Struktur angegeben. Die Formatdetails werden in der struktur zurückgegeben, die von pafddefiniert wird. Der Index reicht von 0 bis 1 kleiner als die cStandardFormats Member, das in der ACMFORMATTAGDETAILS Struktur für ein Formattag zurückgegeben wird. Eine Anwendung muss ein Treiberhandle für beim Abrufen von Formatdetails mit dieser Kennzeichnung haben. Informationen dazu, welche Member vor dem Aufrufen dieser Funktion initialisiert werden sollen, finden Sie in der ACMFORMATDETAILS Struktur.

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 ACMFORMATDETAILS als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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