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.
Sintassi
MMRESULT ACMAPI acmFilterChoose(
LPACMFILTERCHOOSE 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]() è 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. |
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 |