acmFormatChooseA-Funktion (msacm.h)
Die acmFormatChoose--Funktion erstellt ein ACM-definiertes Dialogfeld, mit dem der Benutzer ein Waveform-Audioformat auswählen kann.
Syntax
MMRESULT ACMAPI acmFormatChooseA(
LPACMFORMATCHOOSEA pafmtc
);
Parameter
pafmtc
Zeigen Sie auf eine ACMFORMATCHOOSE- Struktur, die Informationen enthält, die zum Initialisieren des Dialogfelds verwendet werden. Wenn diese Funktion zurückgegeben wird, enthält diese Struktur Informationen zur Formatauswahl des Benutzers.
Das pwfx- Mitglied dieser Struktur muss einen gültigen Zeiger auf einen Speicherspeicherort enthalten, der die zurückgegebene Formatheaderstruktur enthält. Darüber hinaus muss das cbwfx Member mit der Größe dieses Speicherpuffers in Byte ausgefüllt werden.
Rückgabewert
Gibt MMSYSERR_NOERROR zurück, wenn dies erfolgreich ist oder andernfalls ein Fehler auftritt. Mögliche Rückgabewerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Benutzer hat die Schaltfläche "Abbrechen" oder den Befehl "Schließen" im Menü "System" ausgewählt, um das Dialogfeld zu schließen. |
|
Der vom pwfx Member des ACMFORMATCHOOSE Struktur identifizierte Puffer ist zu klein, um das ausgewählte Format zu enthalten. |
|
Mindestens ein Kennzeichen ist ungültig. |
|
Der angegebene Handle ist ungültig. |
|
Mindestens ein Parameter ist ungültig. |
|
Ein geeigneter Treiber ist nicht verfügbar, um gültige Formatauswahlen bereitzustellen. |
Bemerkungen
Anmerkung
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 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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | msacm.h |
| Library | Msacm32.lib |
| DLL- | Msacm32.dll |