Funzione acmFilterEnumA (msacm.h)

Articolo
11/20/2024

La funzione acmFilterEnum enumera i filtri audio waveform disponibili per un tag di filtro specifico 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 acmFilterEnumA(
  HACMDRIVER          had,
  LPACMFILTERDETAILSA pafd,
  ACMFILTERENUMCBA    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, è necessario inizializzare i membri cbStruct, pwfltre cbwfltr di questa struttura. Il membro dwFilterTag deve essere inizializzato anche per WAVE_FILTER_UNKNOWN o 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 di 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 possibili valori di errore includono quanto segue.

Codice restituito	Descrizione
ACMERR_NOTPOSSIBLE	Impossibile 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.

Osservazioni

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, acmDriverRemovee 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	msacm.h
libreria	Msacm32.lib
dll	Msacm32.dll

Vedere anche

funzioni di compressione audio

gestione compressione audio

Condividi tramite