acmFormatChooseA-Funktion (msacm.h)

  • Artikel

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

Syntax

MMRESULT ACMAPI acmFormatChooseA(
  LPACMFORMATCHOOSEA 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.

Hinweise

Hinweis

Der msacm.h-Header definiert ACMFORMATCHOOSE 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 nicht codierungsneutralem Code 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
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