Funzione acmFormatChooseW (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 acmFormatChooseW(
  LPACMFORMATCHOOSEW pafmtc
);

Parametri

pafmtc

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

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

Valore restituito

Restituisce MMSYSERR_NOERROR in caso di esito positivo o di errore. I valori restituiti possibili includono quanto segue.

Codice restituito	Descrizione
ACMERR_CANCELED	L'utente ha scelto il pulsante Annulla o il comando Chiudi nel menu Sistema per chiudere la finestra di dialogo.
ACMERR_NOTPOSSIBLE	Il buffer identificato dal membro pwfx della struttura di 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 adatto non è disponibile per fornire selezioni di formato valide.

Osservazioni

Nota

L'intestazione msacm.h definisce ACMFORMATCHOOSE come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	msacm.h
libreria	Msacm32.lib
dll	Msacm32.dll

Vedere anche

funzioni di compressione audio

gestione compressione audio