acmFormatChoose-Funktion (msacm.h)

Die acmFormatChoose-Funktion erstellt ein von ACM definiertes Dialogfeld, mit dem der Benutzer ein Waveform-Audioformat auswählen kann.

Syntax

MMRESULT ACMAPI acmFormatChoose(
  LPACMFORMATCHOOSE pafmtc
);

Parameter

pafmtc

Zeiger auf eine ACMFORMATCHOOSE-Struktur , die Informationen enthält, die zum Initialisieren des Dialogfelds verwendet werden. Wenn diese Funktion zurückgibt, enthält diese Struktur Informationen zur Formatauswahl des Benutzers.

Das pwfx-Element dieser Struktur muss einen gültigen Zeiger auf einen Speicherspeicherort enthalten, der die zurückgegebene Formatheaderstruktur enthält. Darüber hinaus muss der cbwfx-Member mit der Größe dieses Speicherpuffers in Bytes ausgefüllt werden.

Rückgabewert

Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist. Folgende Rückgabewerte sind möglich.

Rückgabecode Beschreibung
ACMERR_CANCELED
Der Benutzer hat im Menü System die Schaltfläche Abbrechen oder den Befehl Schließen ausgewählt, um das Dialogfeld zu schließen.
ACMERR_NOTPOSSIBLE
Der vom pwfx-Member der ACMFORMATCHOOSE-Struktur identifizierte Puffer ist zu klein, um das ausgewählte Format zu enthalten.
MMSYSERR_INVALFLAG
Mindestens ein Flag ist ungültig.
MMSYSERR_INVALHANDLE
Das angegebene Handle ist ungültig.
MMSYSERR_INVALPARAM
Mindestens ein Parameter ist ungültig.
MMSYSERR_NODRIVER
Ein geeigneter Treiber ist nicht verfügbar, um gültige Formatauswahlen bereitzustellen.

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

Weitere Informationen

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager