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
ACMERR_NOTPOSSIBLE	Non è possibile restituire i dettagli per il filtro.
MMSYSERR_INVALFLAG	Almeno un flag non è valido.
MMSYSERR_INVALHANDLE	L'handle specificato non è valido.
MMSYSERR_INVALPARAM	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

Vedi anche

Funzioni di compressione audio

Gestione compressione audio