Share via


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
ACMERR_CANCELED
L'utente ha scelto il pulsante Annulla o il comando Chiudi del menu Sistema per chiudere la finestra di dialogo.
ACMERR_NOTPOSSIBLE
Il buffer identificato dalla struttura [ACMFILTERCHOOSE]() è troppo piccolo per contenere il filtro selezionato.
MMSYSERR_INVALFLAG
Almeno un flag non è valido.
MMSYSERR_INVALHANDLE
L'handle specificato non è valido.
MMSYSERR_INVALPARAM
Almeno un parametro non è valido.
MMSYSERR_NODRIVER
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

Vedi anche

Funzioni di compressione audio

Gestione compressione audio