funzione acmFormatChooseA (msacm.h)
La funzione acmFormatChoose crea una finestra di dialogo definita da ACM che consente all'utente di selezionare un formato waveform-audio.
Sintassi
MMRESULT ACMAPI acmFormatChooseA(
LPACMFORMATCHOOSEA pafmtc
);
Parametri
pafmtc
Puntatore a una struttura ACMFORMATCHOOSE che contiene informazioni usate per inizializzare la finestra di dialogo. Quando questa funzione restituisce, questa struttura contiene informazioni sulla selezione del formato dell'utente.
Il membro pwfx di questa struttura deve contenere un puntatore valido a una posizione di memoria che conterrà la struttura dell'intestazione di formato restituita. Inoltre, il membro cbwfx deve essere compilato con le dimensioni, in byte, di questo buffer di memoria.
Valore restituito
Restituisce MMSYSERR_NOERROR se ha esito positivo o un errore in caso contrario. I valori restituiti possibili includono quanto segue.
| Codice restituito | Descrizione |
|---|---|
|
L'utente ha scelto il pulsante Annulla o il comando Chiudi nel menu Sistema per chiudere la finestra di dialogo. |
|
Il buffer identificato dal membro pwfx della struttura ACMFORMATCHOOSE è troppo piccolo per contenere il formato selezionato. |
|
Almeno un flag non è valido. |
|
L'handle specificato non è valido. |
|
Almeno un parametro non è valido. |
|
Un driver adatto non è disponibile per fornire selezioni di formato valide. |
Commenti
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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |