funzione acmFilterTagEnum (msacm.h)

La funzione acmFilterTagEnum enumera i tag di filtro audio waveform disponibili da un driver ACM. Questa funzione continua l'enumerazione finché non sono presenti tag di filtro più adatti o la funzione di callback restituisce FALSE.

Sintassi

MMRESULT ACMAPI acmFilterTagEnum(
  HACMDRIVER            had,
  LPACMFILTERTAGDETAILS paftd,
  ACMFILTERTAGENUMCB    fnCallback,
  DWORD_PTR             dwInstance,
  DWORD                 fdwEnum
);

Parametri

had

Gestire il driver ACM per eseguire una query per ottenere i dettagli del tag di filtro audio waveform. Se questo parametro è NULL, ACM usa i dettagli del primo driver ACM appropriato.

paftd

Puntatore alla struttura ACMFILTERTAGDETAILS che contiene i dettagli del tag di filtro quando viene passato alla funzione fnCallback . Quando l'applicazione chiama acmFilterTagEnum, il membro cbStruct di questa struttura deve essere inizializzato.

fnCallback

Indirizzo dell'istanza di routine della funzione di callback definita dall'applicazione.

dwInstance

Valore definito dall'applicazione a 64 bit (DWORD_PTR) o A 32 bit (DWORD) passato alla funzione di callback insieme ai dettagli del tag di filtro ACM.

fdwEnum

Riservati; deve essere zero.

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
MMSYSERR_INVALFLAG	Almeno un flag non è valido.
MMSYSERR_INVALHANDLE	L'handle specificato non è valido.
MMSYSERR_INVALPARAM	Almeno un parametro non è valido.

Commenti

Questa funzione restituirà MMSYSERR_NOERROR (zero) se non sono installati driver ACM appropriati. Inoltre, la funzione di callback non verrà chiamata.

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