funzione acmFormatChoose (msacm.h)

La funzione acmFormatChoose crea una finestra di dialogo definita da ACM che consente all'utente di selezionare un formato audio waveform.

Sintassi

MMRESULT ACMAPI acmFormatChoose(
  LPACMFORMATCHOOSE pafmtc
);

Parametri

pafmtc

Puntatore a una struttura ACMFORMATCHOOSE contenente informazioni utilizzate per inizializzare la finestra di dialogo. Quando questa funzione viene restituita, questa struttura contiene informazioni sulla selezione del formato dell'utente.

Il membro pwfx di questa struttura deve contenere un puntatore valido a un percorso di memoria che conterrà la struttura dell'intestazione del formato restituito. Inoltre, il membro cbwfx deve essere compilato con le dimensioni, in byte, di questo buffer di memoria.

Valore restituito

Restituisce MMSYSERR_NOERROR se l'esito positivo o un errore in caso contrario. I valori restituiti possibili includono quanto segue.

Codice restituito	Descrizione
ACMERR_CANCELED	L'utente ha scelto il pulsante Annulla o il comando Chiudi del menu Sistema per chiudere la finestra di dialogo.
ACMERR_NOTPOSSIBLE	Il buffer identificato dal membro pwfx della struttura ACMFORMATCHOOSE è troppo piccolo per contenere il formato selezionato.
MMSYSERR_INVALFLAG	Almeno un flag non è valido.
MMSYSERR_INVALHANDLE	L'handle specificato non è valido.
MMSYSERR_INVALPARAM	Almeno un parametro non è valido.
MMSYSERR_NODRIVER	Un driver appropriato non è disponibile per fornire selezioni di formato valide.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msacm.h
Libreria	Msacm32.lib
DLL	Msacm32.dll

Vedi anche

Funzioni di compressione audio

Gestione compressione audio