acmFilterTagDetailsW-Funktion (msacm.h)

Die acmFilterTagDetails-Funktion fragt den ACM nach Details zu einem bestimmten Waveform-Audio-Filtertag ab.

Syntax

MMRESULT ACMAPI acmFilterTagDetailsW(
  HACMDRIVER             had,
  LPACMFILTERTAGDETAILSW paftd,
  DWORD                  fdwDetails
);

Parameter

had

Handle an den ACM-Treiber, um Details des Waveform-Audio-Filtertags abzufragen. Wenn dieser Parameter NULL ist, verwendet der ACM die Details aus dem ersten geeigneten ACM-Treiber. Eine Anwendung muss bei Verwendung des Abfragetyps ACM_FILTERTAGDETAILSF_INDEX einen gültigen HACMDRIVER - oder HACMDRIVERID-Bezeichner angeben. Treiber-IDs für deaktivierte Treiber sind nicht zulässig.

paftd

Zeiger auf die ACMFILTERTAGDETAILS-Struktur , die die Details des Filtertags empfangen soll.

fdwDetails

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

[ACMFILTERTAGDETAILS] (./nf-msacm-acmfiltertagdetails.md)-Struktur. Die Details des Filtertags werden in der Struktur zurückgegeben, auf die paftd verweist. Wenn eine Anwendung ein ACM-Treiberhandle für had angibt, werden Details zum Filtertag 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. [ACMDRIVERDETAILS] (./nf-msacm-acmdriverdetails.md)-Struktur für einen ACM-Treiber. Eine Anwendung muss beim Abrufen von Filtertagdetails mit diesem Flag ein Treiberhandle für "had " angeben.

Wert	Bedeutung
ACM_FILTERTAGDETAILSF_FILTERTAG
ACM_FILTERTAGDETAILSF_INDEX
ACM_FILTERTAGDETAILSF_LARGESTSIZE	Details zum Filtertag mit der größten Filtergröße in Bytes sind zurückzugeben. Das dwFilterTag-Element muss entweder WAVE_FILTER_UNKNOWN oder das Filtertag 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 Filtertag für diesen Treiber zurückgegeben. Wenn eine Anwendung NULL für had angibt, findet der ACM einen akzeptablen Treiber mit dem größten Filtertag, der angefordert wird, um die Details zurückzugeben.

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.

Hinweise

Hinweis

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

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