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 |
|---|---|
|
Die angeforderten Details sind nicht verfügbar. |
|
Mindestens ein Flag ist ungültig. |
|
Das angegebene Handle ist ungültig. |
|
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 |