acmFilterDetailsA-Funktion (msacm.h)

Artikel
11/20/2024

Die acmFilterDetails-Funktion fragt die ACM nach Details zu einem Filter mit einem bestimmten Waveform-Audiofiltertag ab.

Syntax

MMRESULT ACMAPI acmFilterDetailsA(
  HACMDRIVER          had,
  LPACMFILTERDETAILSA pafd,
  DWORD               fdwDetails
);

Parameter

had

Behandeln Sie den ACM-Treiber, um Details des Waveform-Audiofilters für ein Filtertag abzufragen. Wenn dieser Parameter NULL-ist, verwendet das ACM die Details des ersten geeigneten ACM-Treibers.

pafd

Zeigen Sie auf die ACMFILTERDETAILS Struktur, die die Filterdetails für das angegebene Filtertag empfängt.

fdwDetails

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

[ACMFILTERDETAILS](./nf-msacm-acmfilterdetails.md) Struktur wurde angegeben, und die verbleibenden Details sollten zurückgegeben werden. Das dwFilterTag Mitglied der ACMFILTERDETAILS- Struktur muss auf dasselbe Filtertag initialisiert werden, pwfltr angibt. Dieser Abfragetyp kann verwendet werden, um eine Zeichenfolgenbeschreibung einer beliebigen Filterstruktur abzurufen. Wenn eine Anwendung ein ACM-Treiberhandle für angibt, werden Details zum Filter für diesen Treiber zurückgegeben. Wenn eine Anwendung NULL- für angibt, findet die ACM den ersten zulässigen Treiber, um die Details zurückzugeben.

Wert	Bedeutung
ACM_FILTERDETAILSF_FILTER
ACM_FILTERDETAILSF_INDEX	Ein Filterindex für das Filtertag wurde im dwFilterIndex Member der ACMFILTERDETAILS Struktur angegeben. Die Filterdetails werden in der struktur zurückgegeben, die von pafddefiniert wird. Der Index reicht von Null bis 1 kleiner als der cStandardFilters Member, der in der ACMFILTERTAGDETAILS Struktur für ein Filtertag zurückgegeben wird. Eine Anwendung muss ein Treiberhandle für beim Abrufen von Filterdetails mit dieser Kennzeichnung haben. 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 Member der ACMFILTERDETAILS Struktur angegeben. Die Filterdetails werden in der struktur zurückgegeben, die von pafddefiniert wird. Der Index reicht von Null bis 1 kleiner als der cStandardFilters Member, der in der ACMFILTERTAGDETAILS Struktur für ein Filtertag zurückgegeben wird. Eine Anwendung muss ein Treiberhandle für beim Abrufen von Filterdetails mit dieser Kennzeichnung haben. 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 dies erfolgreich ist 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 Kennzeichen ist ungültig.
MMSYSERR_INVALHANDLE	Der angegebene Handle ist ungültig.
MMSYSERR_INVALPARAM	Mindestens ein Parameter ist ungültig.

Bemerkungen

Anmerkung

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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	msacm.h
Library	Msacm32.lib
DLL-	Msacm32.dll

Siehe auch

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager

Freigeben über