acmFormatDetails-Funktion (msacm.h)
Die acmFormatDetails-Funktion fragt den ACM nach Formatdetails für ein bestimmtes Waveform-Audio-Formattag ab.
Syntax
MMRESULT ACMAPI acmFormatDetails(
HACMDRIVER had,
LPACMFORMATDETAILS pafd,
DWORD fdwDetails
);
Parameter
had
Handle an den ACM-Treiber, um Details des Waveform-Audioformats für ein Formattag abzufragen. Wenn dieser Parameter NULL ist, verwendet der ACM die Details aus dem ersten geeigneten ACM-Treiber.
pafd
Zeiger auf eine ACMFORMATDETAILS-Struktur , die die Formatdetails für das angegebene Formattag enthält.
fdwDetails
Flags zum Abrufen der Tagdetails des Waveform-Audioformats. Die folgenden Werte werden definiert.
[ACMFORMATDETAILS] () -Struktur angegeben wurde, und die restlichen Details sollten zurückgegeben werden. Das dwFormatTag-Element der ACMFORMATDETAILS-Struktur muss mit demselben Formattag initialisiert werden, wie pwfx angibt. Dieser Abfragetyp kann verwendet werden, um eine Zeichenfolgenbeschreibung einer beliebigen Formatstruktur abzurufen. Wenn eine Anwendung ein ACM-Treiberhandle für had angibt, werden Details zum Format 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.| Wert | Bedeutung |
|---|---|
| ACM_FORMATDETAILSF_FORMAT | |
| ACM_FORMATDETAILSF_INDEX | Ein Formatindex für das Formattag wurde im dwFormatIndex-Element der ACMFORMATDETAILS-Struktur angegeben. Die Formatdetails werden in der durch pafd definierten Struktur zurückgegeben. Der Index reicht von null bis eins kleiner als der cStandardFormats-Member , der in der ACMFORMATTAGDETAILS-Struktur für ein Formattag zurückgegeben wird. Eine Anwendung muss beim Abrufen von Formatdetails mit diesem Flag ein Treiberhandle für "had " angeben. Informationen dazu, welche Member vor dem Aufrufen dieser Funktion initialisiert werden sollen, finden Sie in der ACMFORMATDETAILS-Struktur . |
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. |
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 |
| Bibliothek | Msacm32.lib |
| DLL | Msacm32.dll |