funzione acmFilterChoose (msacm.h)
La funzione acmFilterChoose crea una finestra di dialogo definita da ACM che consente all'utente di selezionare un filtro audio waveform.
MMRESULT ACMAPI acmFilterChoose(
LPACMFILTERCHOOSE pafltrc
);
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.
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]() è 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. |
| 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 |