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 che contiene informazioni utilizzate per inizializzare la finestra di dialogo. Quando acmFilterChoose restituisce, questa struttura contiene informazioni sulla selezione del filtro dell'utente.
Il pwfltr membro 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 in caso di esito positivo o di errore. I possibili valori di errore 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 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 adatto non è disponibile per fornire selezioni di filtro valide. |
Osservazioni
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 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 |