ACMFORMATENUMCB-Rückruffunktion (msacm.h)

  • Artikel

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

Syntax

ACMFORMATENUMCB Acmformatenumcb;

BOOL Acmformatenumcb(
  HACMDRIVERID hadid,
  LPACMFORMATDETAILS pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parameter

hadid

Handle mit dem ACM-Treiberbezeichner.

pafd

Zeiger auf eine ACMFORMATDETAILS-Struktur , die die aufgezählten Formatdetails für ein Formattag enthält.

dwInstance

Anwendungsdefinierter Wert, der in der Funktion acmFormatEnum angegeben ist.

fdwSupport

Treiberunterstützungsflags, die für den durch die ACMDRIVERDETAILS-Struktur identifizierten Treiber spezifisch sind, aber sie sind spezifisch für das Format, das aufgelistet wird. Dieser Parameter kann eine Kombination der folgenden Werte sein und gibt an, welche Vorgänge der Treiber für das 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 für das angegebene Format. Wenn ein Treiber beispielsweise die Komprimierung von WAVE_FORMAT_PCM zu WAVE_FORMAT_ADPCM mit dem angegebenen Format 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 Format verwendet wird. Wenn ein Treiber beispielsweise die Neustempelung von WAVE_FORMAT_PCM in das angegebene Format unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_FILTER Der Treiber unterstützt einen Filter (Änderung der Daten ohne Ändern der Formatattribute) mit dem angegebenen Format. Wenn ein Treiber beispielsweise Volume- oder Echovorgänge auf WAVE_FORMAT_PCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE Der Treiber unterstützt die Hardwareeingabe, -ausgabe oder beide der angegebenen Formattags ü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 Waveform-Audiogerätebezeichner abzurufen, die dem unterstützenden ACM-Treiber zugeordnet sind.

Rückgabewert

Die Rückruffunktion muss TRUE zurückgeben, um die Enumeration fortzusetzen, oder FALSE , um die Enumeration zu beenden.

Hinweise

Die Funktion acmFormatEnum gibt MMSYSERR_NOERROR (null) zurück, wenn keine Formate 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.

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