acmFormatTagDetailsA-Funktion (msacm.h)
Die acmFormatTagDetails-Funktion fragt den ACM nach Details zu einem bestimmten Waveform-Audioformattag ab.
Syntax
MMRESULT ACMAPI acmFormatTagDetailsA(
HACMDRIVER had,
LPACMFORMATTAGDETAILSA paftd,
DWORD fdwDetails
);
Parameter
had
Handle an den ACM-Treiber, um Details des Waveform-Audioformattags abzufragen. Wenn dieser Parameter NULL ist, verwendet der ACM die Details aus dem ersten geeigneten ACM-Treiber. Eine Anwendung muss bei Verwendung des Abfragetyps ACM_FORMATTAGDETAILSF_INDEX ein gültiges Handle oder einen gültigen Treiberbezeichner angeben. Treiber-IDs für deaktivierte Treiber sind nicht zulässig.
paftd
Zeiger auf die ACMFORMATTAGDETAILS-Struktur , die die Formattagdetails empfangen soll.
fdwDetails
Flags zum Abrufen der Details. Die folgenden Werte werden definiert.
[ACMFORMATTAGDETAILS] (./nf-msacm-acmformattagdetails.md)-Struktur. Die Formattagdetails werden in der Struktur zurückgegeben, auf die paftd verweist. Wenn eine Anwendung ein ACM-Treiberhandle für "had" angibt, werden Details zum Formattag für diesen Treiber zurückgegeben. Wenn eine Anwendung NULL für had angibt, findet der ACM den ersten zulässigen Treiber, der die Details zurückgibt. [ACMDRIVERDETAILS] (./nf-msacm-acmdriverdetails.md)-Struktur für einen ACM-Treiber. Eine Anwendung muss beim Abrufen von Formattagdetails mit diesem Flag ein Treiberhandle für "had " angeben. [ACMFORMATTAGDETAILS] (./nf-msacm-acmformattagdetails.md)-Struktur muss entweder WAVE_FORMAT_UNKNOWN oder das Formattag sein, um die größte Größe für zu finden. Wenn eine Anwendung ein ACM-Treiberhandle für "had" angibt, werden Details zum größten Formattag für diesen Treiber zurückgegeben. Wenn eine Anwendung NULL für had angibt, findet der ACM einen akzeptablen Treiber mit dem größten Formattag, der angefordert wird, um die Details zurückzugeben.| Wert | Bedeutung |
|---|---|
| ACM_FORMATTAGDETAILSF_FORMATTAG | |
| ACM_FORMATTAGDETAILSF_INDEX | |
| ACM_FORMATTAGDETAILSF_LARGESTSIZE |
Rückgabewert
Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Die angeforderten Details sind nicht verfügbar. |
|
Mindestens ein Flag ist ungültig. |
|
Das angegebene Handle ist ungültig. |
|
Mindestens ein Parameter ist ungültig. |
Hinweise
Hinweis
Der msacm.h-Header definiert ACMFORMATTAGDETAILS 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 |
| Bibliothek | Msacm32.lib |
| DLL | Msacm32.dll |