Freigeben über


acmFilterDetails-Funktion (msacm.h)

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

Syntax

MMRESULT ACMAPI acmFilterDetails(
  HACMDRIVER         had,
  LPACMFILTERDETAILS pafd,
  DWORD              fdwDetails
);

Parameter

had

Verarbeiten Sie den ACM-Treiber, um nach Waveform-Audiofilterdetails für ein Filtertag abzufragen. Wenn dieser Parameter NULL ist, verwendet der ACM die Details des ersten geeigneten ACM-Treibers.

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] () Struktur wurde angegeben, und die restlichen Details sollten zurückgegeben werden. Das dwFilterTag-Element der ACMFILTERDETAILS-Struktur muss mit demselben Filtertag initialisiert werden, das pwfltr angibt. 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 akzeptablen Treiber, der die Details zurückgibt.
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 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 "für" angeben. Informationen dazu, welche Member vor dem Aufrufen dieser Funktion initialisiert werden sollten, finden Sie in der Struktur ACMFILTERDETAILS .

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.

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