Funzione acmFilterEnum (msacm.h)
La funzione acmFilterEnum enumera i filtri waveform-audio disponibili per un tag di filtro specificato da un driver ACM. Questa funzione continua l'enumerazione finché non sono presenti filtri più adatti per il tag di filtro o la funzione di callback restituisce FALSE.
Sintassi
MMRESULT ACMAPI acmFilterEnum(
HACMDRIVER had,
LPACMFILTERDETAILS pafd,
ACMFILTERENUMCB fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
Parametri
had
Gestire il driver ACM per eseguire una query per ottenere i dettagli del filtro audio waveform. Se questo parametro è NULL, ACM usa i dettagli del primo driver ACM appropriato.
pafd
Puntatore alla struttura ACMFILTERDETAILS che contiene i dettagli del filtro quando viene passato alla funzione specificata da fnCallback. Quando l'applicazione chiama acmFilterEnum, i membri cbStruct, pwfltr e cbwfltr di questa struttura devono essere inizializzati. Il membro dwFilterTag deve essere inizializzato anche in WAVE_FILTER_UNKNOWN o in un tag di filtro valido.
fnCallback
Indirizzo dell'istanza di routine della funzione di callback definita dall'applicazione.
dwInstance
Valore definito dall'applicazione a 32 bit (DWORD), a 64 bit (DWORD_PTR) passato alla funzione di callback insieme ai dettagli del filtro ACM.
fdwEnum
Flag per enumerare i filtri per un tag di filtro specificato. Vengono definiti i valori seguenti.
[ACMFILTERDETAILS] Struttura (./nf-msacm-acmfilterdetails.md) valida. L'enumeratore enumera solo un filtro conforme a questo attributo. Il membro dwFilterTag della struttura ACMFILTERDETAILS deve essere uguale al membro dwFilterTag della struttura WAVEFILTER .| Valore | Significato |
|---|---|
| ACM_FILTERENUMF_DWFILTERTAG |
Valore restituito
Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.
| Codice restituito | Descrizione |
|---|---|
|
Non è possibile restituire i dettagli per il filtro. |
|
Almeno un flag non è valido. |
|
L'handle specificato non è valido. |
|
Almeno un parametro non è valido. |
Commenti
La funzione acmFilterEnum restituirà MMSYSERR_NOERROR (zero) se non sono installati driver ACM appropriati. Inoltre, la funzione di callback non verrà chiamata.
Le funzioni seguenti non devono essere chiamate dall'interno della funzione di callback: acmDriverAdd, acmDriverRemove e acmDriverPriority.
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 |