Freigeben über


acmFormatDetails-Funktion (msacm.h)

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

Syntax

MMRESULT ACMAPI acmFormatDetails(
  HACMDRIVER         had,
  LPACMFORMATDETAILS pafd,
  DWORD              fdwDetails
);

Parameter

had

Handle an den ACM-Treiber, um Details des Waveform-Audioformats für ein Formattag abzufragen. Wenn dieser Parameter NULL ist, verwendet der ACM die Details aus dem ersten geeigneten ACM-Treiber.

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] () -Struktur angegeben wurde, und die restlichen Details sollten zurückgegeben werden. Das dwFormatTag-Element der ACMFORMATDETAILS-Struktur muss mit demselben Formattag initialisiert werden, wie pwfx angibt. Dieser Abfragetyp kann verwendet werden, um eine Zeichenfolgenbeschreibung einer beliebigen Formatstruktur 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 zulässigen Treiber, der die Details zurückgibt.
Wert Bedeutung
ACM_FORMATDETAILSF_FORMAT
ACM_FORMATDETAILSF_INDEX Ein Formatindex für das Formattag wurde im dwFormatIndex-Element der ACMFORMATDETAILS-Struktur angegeben. Die Formatdetails werden in der durch 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 "had " angeben. 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 erfolgreich 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 Flag ist ungültig.
MMSYSERR_INVALHANDLE
Das angegebene Handle ist ungültig.
MMSYSERR_INVALPARAM
Mindestens ein Parameter ist ungültig.

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