ACMFILTERENUMCBW-Rückruffunktion (msacm.h)
Die acmFilterEnumCallback--Funktion gibt eine Rückruffunktion an, die mit der acmFilterEnum--Funktion verwendet wird. Der acmFilterEnumCallback Name ist ein Platzhalter für einen anwendungsdefinierte Funktionsnamen.
Syntax
ACMFILTERENUMCBW Acmfilterenumcbw;
BOOL Acmfilterenumcbw(
HACMDRIVERID hadid,
LPACMFILTERDETAILSW pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parameter
hadid
Behandeln Sie den ACM-Treiberbezeichner.
pafd
Zeigen Sie auf eine ACMFILTERDETAILS Struktur, die die aufgezählten Filterdetails für ein Filtertag enthält.
dwInstance
Anwendungsdefinierter Wert in acmFilterEnumangegeben.
fdwSupport
Treiberunterstützungskennzeichnungen, die spezifisch für den Treiber sind, der durch ACMDRIVERDETAILS Struktur identifiziert wird, sie sind jedoch spezifisch für den Filter, der aufgezählt wird. Dieser Parameter kann eine Kombination der folgenden Werte sein und identifiziert, welche Vorgänge der Treiber für das 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 bei Verwendung des angegebenen Filters. Wenn beispielsweise ein Treiber die Komprimierung von WAVE_FORMAT_PCM in WAVE_FORMAT_ADPCM mit dem angegebenen Filter unterstützt, wird dieses Kennzeichen festgelegt. |
| ACMDRIVERDETAILS_SUPPORTF_CONVERTER | Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formatformaten desselben Formattags bei Verwendung des angegebenen Filters. Wenn beispielsweise ein Treiber das Resampling von WAVE_FORMAT_PCM mit dem angegebenen Filter unterstützt, wird dieses Flag festgelegt. |
| ACMDRIVERDETAILS_SUPPORTF_FILTER | Der Treiber unterstützt einen Filter (Änderung der Daten, ohne die Formatattribute zu ändern). Wenn ein Treiber z. B. Volume- oder Echovorgänge für WAVE_FORMAT_PCM unterstützt, wird dieses Kennzeichen festgelegt. |
| ACMDRIVERDETAILS_SUPPORTF_HARDWARE | Der Treiber unterstützt Hardwareeingabe, Ausgabe oder beides mit dem angegebenen Filter über ein Waveform-Audiogerät. Eine Anwendung sollte die acmMetrics--Funktion mit den ACM_METRIC_HARDWARE_WAVE_INPUT und ACM_METRIC_HARDWARE_WAVE_OUTPUT metrischen Indizes verwenden, um die mit dem unterstützenden ACM-Treiber verknüpften Waveform-Audiogerätebezeichner abzurufen. |
Rückgabewert
Die Rückruffunktion muss TRUE- zurückgeben, um die Aufzählung fortzusetzen, oder FALSE-, um die Aufzählung zu beenden.
Bemerkungen
Die acmFilterEnum-Funktion gibt MMSYSERR_NOERROR (Null) zurück, wenn keine Filter aufgezählt werden sollen. Darüber hinaus wird die Rückruffunktion nicht aufgerufen.
Die folgenden Funktionen sollten nicht innerhalb der Rückruffunktion aufgerufen werden: acmDriverAdd, acmDriverRemoveund acmDriverPriority.
Anmerkung
Der msacm.h-Header definiert ACMFILTERENUMCB 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 |