ACMFORMATTAGENUMCBW-Rückruffunktion (msacm.h)

  • Artikel

Die Funktion acmFormatTagEnumCallback gibt eine Rückruffunktion an, die mit der Funktion acmFormatTagEnum verwendet wird. Der Name acmFormatTagEnumCallback ist ein Platzhalter für einen anwendungsdefinierten Funktionsnamen.

Syntax

ACMFORMATTAGENUMCBW Acmformattagenumcbw;

BOOL Acmformattagenumcbw(
  HACMDRIVERID hadid,
  LPACMFORMATTAGDETAILSW paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parameter

hadid

Handle für den ACM-Treiberbezeichner.

paftd

Zeiger auf eine ACMFORMATTAGDETAILS-Struktur , die die Details des aufgezählten Formattags enthält.

dwInstance

Anwendungsdefinierter Wert, der in der Funktion acmFormatTagEnum angegeben ist.

fdwSupport

Treiberunterstützungsflags, die für das Formattag spezifisch sind. Diese Flags sind mit der ACMDRIVERDETAILS-Struktur identisch. 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 ein Treiber beispielsweise die Komprimierung von WAVE_FORMAT_PCM zu WAVE_FORMAT_ADPCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formaten des angegebenen Formattags. Wenn z. B. ein Treiber das ErneutesAmpling von WAVE_FORMAT_PCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_FILTER Der Treiber unterstützt einen Filter (Änderung der Daten ohne Änderung der Formatattribute). Wenn beispielsweise ein Treiber Volume- oder Echovorgänge für das angegebene Formattag unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE Der Treiber unterstützt die 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 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 acmFormatTagEnum-Funktion gibt MMSYSERR_NOERROR (null) zurück, wenn keine Formattags 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 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

   
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

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager