ACMFORMATTAGENUMCBA-Rückruffunktion (msacm.h)
Die acmFormatTagEnumCallback--Funktion gibt eine Rückruffunktion an, die mit der acmFormatTagEnum--Funktion verwendet wird. Der acmFormatTagEnumCallback Name ist ein Platzhalter für einen anwendungsdefinierten Funktionsnamen.
Syntax
ACMFORMATTAGENUMCBA Acmformattagenumcba;
BOOL Acmformattagenumcba(
HACMDRIVERID hadid,
LPACMFORMATTAGDETAILSA paftd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parameter
hadid
Behandeln Sie den ACM-Treiberbezeichner.
paftd
Zeigen Sie auf eine ACMFORMATTAGDETAILS Struktur, die die Details des Aufzählungsformattags enthält.
dwInstance
Anwendungsdefinierter Wert, der in der acmFormatTagEnum--Funktion angegeben ist.
fdwSupport
Treiberunterstützungskennzeichnungen, die für das Formattag spezifisch sind. Diese Flags sind identisch mit der ACMDRIVERDETAILS Struktur. Dieser Parameter kann eine Kombination der folgenden Werte sein und gibt an, welche Vorgänge der Treiber mit dem Formattag 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, wobei eines der Tags das angegebene Formattag ist. Wenn beispielsweise ein Treiber die Komprimierung von WAVE_FORMAT_PCM in WAVE_FORMAT_ADPCM unterstützt, wird dieses Kennzeichen festgelegt. |
| ACMDRIVERDETAILS_SUPPORTF_CONVERTER | Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formaten des angegebenen Formattags. Wenn z. B. ein Treiber das Resampling von WAVE_FORMAT_PCM unterstützt, wird dieses Kennzeichen 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 das angegebene Formattag unterstützt, wird dieses Kennzeichen festgelegt. |
| ACMDRIVERDETAILS_SUPPORTF_HARDWARE | Der Treiber unterstützt Hardwareeingabe, Ausgabe oder beides des angegebenen Formattags über ein Waveform-Audiogerät. Eine Anwendung sollte acmMetrics- mit den ACM_METRIC_HARDWARE_WAVE_INPUT und ACM_METRIC_HARDWARE_WAVE_OUTPUT Metrikindizes 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 acmFormatTagEnum--Funktion gibt MMSYSERR_NOERROR (Null) zurück, wenn keine Formattags 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 ACMFORMATTAGENUMCB 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 |