acmFormatDetailsA-Funktion (msacm.h)

Artikel
08/24/2023

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

Syntax

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

Parameter

had

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

pafd

Zeiger auf eine ACMFORMATDETAILS-Struktur , die die Formatdetails für das angegebene Formattag enthält.

fdwDetails

Flags zum Abrufen der Tagdetails des Waveform-Audioformats. Die folgenden Werte werden definiert.

[ACMFORMATDETAILS] (./nf-msacm-acmformatdetails.md) -Struktur wurde angegeben, und die restlichen Details sollten zurückgegeben werden. Das dwFormatTag-Element der ACMFORMATDETAILS-Struktur muss mit dem gleichen Formattag initialisiert werden, wie pwfx angibt. Dieser Abfragetyp kann verwendet werden, um eine Zeichenfolgenbeschreibung einer Struktur im beliebigen Format abzurufen. Wenn eine Anwendung ein ACM-Treiberhandle für had angibt, werden Details zum Format für diesen Treiber zurückgegeben. Wenn eine Anwendung NULL für "had" angibt, findet der ACM den ersten akzeptablen Treiber, der die Details zurückgibt.

Wert	Bedeutung
ACM_FORMATDETAILSF_FORMAT
ACM_FORMATDETAILSF_INDEX	Ein Formatindex für das format-Tag wurde im dwFormatIndex-Member der ACMFORMATDETAILS-Struktur angegeben. Die Formatdetails werden in der von pafd definierten Struktur zurückgegeben. Der Index reicht von null bis eins kleiner als der cStandardFormats-Member , der in der ACMFORMATTAGDETAILS-Struktur für ein Formattag zurückgegeben wird. Eine Anwendung muss beim Abrufen von Formatdetails mit diesem Flag ein Treiberhandle für "für" angeben. Informationen dazu, welche Member vor dem Aufrufen dieser Funktion initialisiert werden sollten, finden Sie in der Struktur ACMFORMATDETAILS .

Wert

Bedeutung

ACM_FORMATDETAILSF_FORMAT

ACM_FORMATDETAILSF_INDEX

Ein Formatindex für das format-Tag wurde im dwFormatIndex-Member der ACMFORMATDETAILS-Struktur angegeben. Die Formatdetails werden in der von pafd definierten Struktur zurückgegeben. Der Index reicht von null bis eins kleiner als der cStandardFormats-Member , der in der ACMFORMATTAGDETAILS-Struktur für ein Formattag zurückgegeben wird. Eine Anwendung muss beim Abrufen von Formatdetails mit diesem Flag ein Treiberhandle für "für" angeben. Informationen dazu, welche Member vor dem Aufrufen dieser Funktion initialisiert werden sollten, finden Sie in der Struktur ACMFORMATDETAILS .

Rückgabewert

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

Rückgabecode	Beschreibung
ACMERR_NOTPOSSIBLE	Die angeforderten Details sind nicht verfügbar.
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

Hinweis

Der msacm.h-Header definiert ACMFORMATDETAILS 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


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