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 |
|---|---|
|
Der Benutzer hat im Menü System die Schaltfläche Abbrechen oder den Befehl Schließen ausgewählt, um das Dialogfeld zu schließen. |
|
Der vom pwfx-Member der ACMFORMATCHOOSE-Struktur identifizierte Puffer ist zu klein, um das ausgewählte Format zu enthalten. |
|
Mindestens ein Flag ist ungültig. |
|
Das angegebene Handle ist ungültig. |
|
Mindestens ein Parameter ist ungültig. |
|
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 |