acmFilterDetailsW-Funktion (msacm.h)

Artikel
03/06/2024

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

Syntax

MMRESULT ACMAPI acmFilterDetailsW(
  HACMDRIVER          had,
  LPACMFILTERDETAILSW pafd,
  DWORD               fdwDetails
);

Parameter

had

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

pafd

Zeiger auf die ACMFILTERDETAILS-Struktur , die die Filterdetails für das angegebene Filtertag empfangen soll.

fdwDetails

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

[ACMFILTERDETAILS] (./nf-msacm-acmfilterdetails.md)-Struktur wurde angegeben, und die restlichen Details sollten zurückgegeben werden. Der dwFilterTag-Member der ACMFILTERDETAILS-Struktur muss mit dem von pwfltr angegebenen Filtertag initialisiert werden. Dieser Abfragetyp kann verwendet werden, um eine Zeichenfolgenbeschreibung einer beliebigen Filterstruktur abzurufen. Wenn eine Anwendung ein ACM-Treiberhandle für had angibt, werden Details zum Filter 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_FILTERDETAILSF_FILTER
ACM_FILTERDETAILSF_INDEX	Ein Filterindex für das Filtertag wurde im dwFilterIndex-Element der ACMFILTERDETAILS-Struktur angegeben. Die Filterdetails werden in der durch pafd definierten Struktur zurückgegeben. Der Index reicht von null bis eins kleiner als der cStandardFilters-Member , der in der ACMFILTERTAGDETAILS-Struktur für ein Filtertag zurückgegeben wird. Eine Anwendung muss beim Abrufen von Filterdetails 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 ACMFILTERDETAILS-Struktur .

Wert

Bedeutung

ACM_FILTERDETAILSF_FILTER

ACM_FILTERDETAILSF_INDEX

Ein Filterindex für das Filtertag wurde im dwFilterIndex-Element der ACMFILTERDETAILS-Struktur angegeben. Die Filterdetails werden in der durch pafd definierten Struktur zurückgegeben. Der Index reicht von null bis eins kleiner als der cStandardFilters-Member , der in der ACMFILTERTAGDETAILS-Struktur für ein Filtertag zurückgegeben wird. Eine Anwendung muss beim Abrufen von Filterdetails 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 ACMFILTERDETAILS-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.

Hinweise

Hinweis

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

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