acmFilterTagDetailsA-Funktion (msacm.h)
Die Funktion acmFilterTagDetails fragt den ACM nach Details zu einem bestimmten Waveform-Audiofiltertag ab.
Syntax
MMRESULT ACMAPI acmFilterTagDetailsA(
HACMDRIVER had,
LPACMFILTERTAGDETAILSA paftd,
DWORD fdwDetails
);
Parameter
had
Verarbeiten Sie den ACM-Treiber, um die Details des Waveform-Audiofiltertags abzufragen. Wenn dieser Parameter NULL ist, verwendet der ACM die Details des ersten geeigneten ACM-Treibers. Eine Anwendung muss einen gültigen HACMDRIVER - oder HACMDRIVERID-Bezeichner angeben, wenn der Abfragetyp ACM_FILTERTAGDETAILSF_INDEX verwendet wird. Treiberbezeichner für deaktivierte Treiber sind nicht zulässig.
paftd
Zeiger auf die ACMFILTERTAGDETAILS-Struktur , die die Filtertagdetails 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 von paftd verwiesen wird. 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 akzeptablen 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 "für" 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 angibt, findet der ACM einen akzeptablen Treiber mit dem größten Filtertag, der zum Zurückgeben der Details angefordert wird. |
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. |
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 nicht codierungsneutralem Code 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für