ACMFILTERTAGENUMCBA-Rückruffunktion (msacm.h)
Die Funktion acmFilterTagEnumCallback gibt eine Rückruffunktion an, die mit der Funktion acmFilterTagEnum verwendet wird. Der Funktionsname acmFilterTagEnumCallback ist ein Platzhalter für einen anwendungsdefinierten Funktionsnamen.
Syntax
ACMFILTERTAGENUMCBA Acmfiltertagenumcba;
BOOL Acmfiltertagenumcba(
HACMDRIVERID hadid,
LPACMFILTERTAGDETAILSA paftd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parameter
hadid
Handle für den ACM-Treiberbezeichner.
paftd
Zeiger auf eine ACMFILTERTAGDETAILS-Struktur , die die Details des aufgezählten Filtertags enthält.
dwInstance
Anwendungsdefinierter Wert, der in acmFilterTagEnum angegeben ist.
fdwSupport
Treiberunterstützungsflags, die für die ACMDRIVERDETAILS-Struktur des Treiberbezeichners spezifisch sind. Dieser Parameter kann eine Kombination der folgenden Werte sein und identifiziert, welche Vorgänge der Treiber mit dem Filtertag unterstützt.
Wert | Bedeutung |
---|---|
ACMDRIVERDETAILS_SUPPORTF_ASYNC | Der Treiber unterstützt asynchrone Konvertierungen mit dem angegebenen Filtertag. |
ACMDRIVERDETAILS_SUPPORTF_CODEC | Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formattags, während das angegebene Filtertag verwendet wird. Wenn ein Treiber beispielsweise die Komprimierung von WAVE_FORMAT_PCM zu WAVE_FORMAT_ADPCM mit dem angegebenen Filtertag unterstützt, wird dieses Flag festgelegt. |
ACMDRIVERDETAILS_SUPPORTF_CONVERTER | Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formaten desselben Formattags, während das angegebene Filtertag verwendet wird. Wenn z. B. ein Treiber das ErneutesAmpling von WAVE_FORMAT_PCM mit dem angegebenen Filtertag unterstützt, wird dieses Flag festgelegt. |
ACMDRIVERDETAILS_SUPPORTF_FILTER | Der Treiber unterstützt einen Filter (Änderung der Daten ohne Änderung der Formatattribute). Wenn ein Treiber beispielsweise Volume- oder Echovorgänge für WAVE_FORMAT_PCM unterstützt, wird dieses Flag festgelegt. |
ACMDRIVERDETAILS_SUPPORTF_HARDWARE | Der Treiber unterstützt Hardwareeingaben, -ausgaben oder beides mit dem angegebenen Filtertag über ein Waveform-Audiogerät. Eine Anwendung sollte die acmMetrics-Funktion mit den ACM_METRIC_HARDWARE_WAVE_INPUT und ACM_METRIC_HARDWARE_WAVE_OUTPUT Metrikindizes verwenden, um die dem unterstützenden ACM-Treiber zugeordneten Waveform-Audio-Gerätebezeichner abzurufen. |
Rückgabewert
Die Rückruffunktion muss TRUE zurückgeben, um die Enumeration fortzusetzen, oder FALSE , um die Enumeration zu beenden.
Hinweise
Die Funktion acmFilterTagEnum gibt MMSYSERR_NOERROR (null) zurück, wenn keine Filtertags aufgelistet werden sollen. Darüber hinaus wird die Rückruffunktion nicht aufgerufen.
Die folgenden Funktionen sollten nicht innerhalb der Rückruffunktion aufgerufen werden: acmDriverAdd, acmDriverRemove und acmDriverPriority.
Hinweis
Der msacm.h-Header definiert ACMFILTERTAGENUMCB 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
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 |
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