ACMFORMATENUMCBA-Rückruffunktion (msacm.h)
Die acmFormatEnumCallback--Funktion gibt eine Rückruffunktion an, die mit der acmFormatEnum-Funktion verwendet wird. Der acmFormatEnumCallback Name ist ein Platzhalter für den anwendungsdefinierten Funktionsnamen.
Syntax
ACMFORMATENUMCBA Acmformatenumcba;
BOOL Acmformatenumcba(
HACMDRIVERID hadid,
LPACMFORMATDETAILSA pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parameter
hadid
Behandeln Sie den ACM-Treiberbezeichner.
pafd
Zeigen Sie auf eine ACMFORMATDETAILS Struktur, die die Aufzählungsformatdetails für ein Formattag enthält.
dwInstance
Application-defined value specified in the acmFormatEnum function.
fdwSupport
Treiberunterstützungskennzeichnungen, die für den Treiber spezifisch sind, der von ACMDRIVERDETAILS Struktur identifiziert wird, sind jedoch spezifisch für das Format, das aufgezählt 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 beispielsweise ein Treiber die Komprimierung von WAVE_FORMAT_PCM in WAVE_FORMAT_ADPCM mit dem angegebenen Format 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 Formats. Wenn z. B. ein Treiber das Resampling von WAVE_FORMAT_PCM in das angegebene Format unterstützt, wird dieses Flag festgelegt. |
| ACMDRIVERDETAILS_SUPPORTF_FILTER | Der Treiber unterstützt einen Filter (Änderungen der Daten, ohne die Formatattribute zu ändern) mit dem angegebenen Format. 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 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 metrischen Indizes verwenden, um die mit dem unterstützenden ACM-Treiber verknüpften Waveform-Audiogeräte-IDs 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 acmFormatEnum--Funktion gibt MMSYSERR_NOERROR (Null) zurück, wenn keine Formate 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 ACMFORMATENUMCB als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 |