acmFormatTagDetailsW-Funktion (msacm.h)

  • Artikel

Die Funktion acmFormatTagDetails fragt den ACM nach Details zu einem bestimmten Tag für das Waveform-Audioformat ab.

Syntax

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

Parameter

had

Verarbeiten Sie den ACM-Treiber, um details des Waveform-Audioformat-Tags abzufragen. Wenn dieser Parameter NULL ist, verwendet der 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

Zeiger auf die ACMFORMATTAGDETAILS-Struktur , die die Formattagdetails empfangen soll.

fdwDetails

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

[ACMFORMATTAGDETAILS] (./nf-msacm-acmformattagdetails.md)-Struktur. Die Formattagdetails werden in der Struktur zurückgegeben, auf die paftd verweist. Wenn eine Anwendung ein ACM-Treiberhandle für "had" angibt, werden Details zum Formattag 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. [ACMDRIVERDETAILS] (./nf-msacm-acmdriverdetails.md)-Struktur für einen ACM-Treiber. Eine Anwendung muss beim Abrufen von Formattagdetails mit diesem Flag ein Treiberhandle für "für" angeben. [ACMFORMATTAGDETAILS] (./nf-msacm-acmformattagdetails.md)-Struktur muss entweder WAVE_FORMAT_UNKNOWN oder das Formattag sein, um die größte Größe für zu finden. Wenn eine Anwendung ein ACM-Treiberhandle für "had" angibt, werden Details zum Größten Formattag für diesen Treiber zurückgegeben. Wenn eine Anwendung NULL für angibt, findet der ACM einen akzeptablen Treiber mit dem größten Formattag, der zum Zurückgeben der Details angefordert wird.
Wert Bedeutung
ACM_FORMATTAGDETAILSF_FORMATTAG
ACM_FORMATTAGDETAILSF_INDEX
ACM_FORMATTAGDETAILSF_LARGESTSIZE

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 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 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

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