ACMDRIVERENUMCB-Rückruffunktion (msacm.h)
Die Funktion acmDriverEnumCallback gibt eine Rückruffunktion an, die mit der Funktion acmDriverEnum verwendet wird. Der Name acmDriverEnumCallback ist ein Platzhalter für einen anwendungsdefinierten Funktionsnamen.
Syntax
ACMDRIVERENUMCB Acmdriverenumcb;
BOOL Acmdriverenumcb(
HACMDRIVERID hadid,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parameter
hadid
Handle für einen ACM-Treiberbezeichner.
dwInstance
Anwendungsdefinierter Wert, der in acmDriverEnum angegeben ist.
fdwSupport
Treiberunterstützungsflags, die für den von der ACMDRIVERDETAILS-Struktur angegebenen Treiber spezifisch sind. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.
| Wert | Bedeutung |
|---|---|
| ACMDRIVERDETAILS_SUPPORTF_ASYNC | Der Treiber unterstützt asynchrone Konvertierungen. |
| ACMDRIVERDETAILS_SUPPORTF_CODEC | Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formattags. 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 desselben Formattags. Wenn z. B. ein Treiber das ErneutesAmpling von WAVE_FORMAT_PCM unterstützt, wird dieses Flag festgelegt. |
| ACMDRIVERDETAILS_SUPPORTF_DISABLED | Der Treiber wurde deaktiviert. Eine Anwendung muss das ACM_DRIVERENUMF_DISABLED-Flag mit acmDriverEnum angeben, um deaktivierte Treiber in die Enumeration einzuschließen. |
| ACMDRIVERDETAILS_SUPPORTF_FILTER | Der Treiber unterstützt einen Filter (Änderung der Daten ohne Änderung der Formatattribute). Wenn ein Treiber beispielsweise Volume- oder Echovorgänge für WAVE_FORMAT_PCM unterstützt, wird dieses Flag festgelegt. |
Rückgabewert
Die Rückruffunktion muss TRUE zurückgeben, um die Enumeration fortzusetzen, oder FALSE , um die Enumeration zu beenden.
Hinweise
Die acmDriverEnum-Funktion gibt MMSYSERR_NOERROR (null) zurück, wenn keine ACM-Treiber installiert sind. 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
| Anforderung | Wert |
|---|---|
| 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 |