funzione acmFilterChooseA (msacm.h)
La funzione acmFilterChoose crea una finestra di dialogo definita da ACM che consente all'utente di selezionare un filtro audio waveform.
Sintassi
MMRESULT ACMAPI acmFilterChooseA(
LPACMFILTERCHOOSEA pafltrc
);
Parametri
pafltrc
Puntatore a una struttura ACMFILTERCHOOSE contenente informazioni utilizzate per inizializzare la finestra di dialogo. Quando acmFilterChoose viene restituito , questa struttura contiene informazioni sulla selezione del filtro dell'utente.
Il membro pwfltr di questa struttura deve contenere un puntatore valido a una posizione di memoria che conterrà la struttura dell'intestazione del filtro restituita. Il membro cbwfltr 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 di errore possibili includono quanto segue.
| Codice restituito | Descrizione |
|---|---|
|
L'utente ha scelto il pulsante Annulla o il comando Chiudi del menu Sistema per chiudere la finestra di dialogo. |
|
Il buffer identificato dalla struttura [ACMFILTERCHOOSE](./nf-msacm-acmfilterchoose.md) è troppo piccolo per contenere il filtro selezionato. |
|
Almeno un flag non è valido. |
|
L'handle specificato non è valido. |
|
Almeno un parametro non è valido. |
|
Un driver appropriato non è disponibile per fornire selezioni di filtro valide. |
Commenti
Nota
L'intestazione msacm.h definisce ACMFILTERCHOOSE 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 |