funzione acmFilterEnumW (msacm.h)
La funzione acmFilterEnum enumera filtri waveform-audio disponibili per un tag di filtro specificato da un driver ACM. Questa funzione continua a enumerare finché non sono presenti filtri più adatti per il tag di filtro o la funzione di callback restituisce FALSE.
Sintassi
MMRESULT ACMAPI acmFilterEnumW(
HACMDRIVER had,
LPACMFILTERDETAILSW pafd,
ACMFILTERENUMCBW fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
Parametri
had
Gestire il driver ACM per eseguire una query sui dettagli del filtro waveform-audio. 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 procedura 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 determinato tag di filtro. I valori seguenti sono definiti.
[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 ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.
Codice restituito | Descrizione |
---|---|
|
I dettagli per il filtro non possono essere restituiti. |
|
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 callback: acmDriverAdd, acmDriverRemove e acmDriverPriority.
Nota
L'intestazione msacm.h definisce acmFilterEnum come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
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 |