Funzione di callback ACMFILTERENUMCB (msacm.h)

La funzione acmFilterEnumCallback specifica una funzione di callback usata con la funzione acmFilterEnum . Il nome acmFilterEnumCallback è un segnaposto per un nome di funzione definito dall'applicazione.

Sintassi

ACMFILTERENUMCB Acmfilterenumcb;

BOOL Acmfilterenumcb(
  HACMDRIVERID hadid,
  LPACMFILTERDETAILS pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parametri

hadid

Gestire l'identificatore del driver ACM.

pafd

Puntatore a una struttura ACMFILTERDETAILS contenente i dettagli del filtro enumerati per un tag di filtro.

dwInstance

Valore definito dall'applicazione specificato in acmFilterEnum.

fdwSupport

Flag di supporto driver specifici per il driver identificato dalla struttura ACMDRIVERDETAILS , ma sono specifici del filtro che viene enumerato. Questo parametro può essere una combinazione dei valori seguenti e identifica quali operazioni supportano il driver per il tag di filtro.

Valore	Significato
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Il driver supporta le conversioni asincrone con il tag di filtro specificato.
ACMDRIVERDETAILS_SUPPORTF_CODEC	Il driver supporta la conversione tra due tag di formato diversi durante l'uso del filtro specificato. Ad esempio, se un driver supporta la compressione da WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM con il filtro specificato, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Il driver supporta la conversione tra due formati diversi dello stesso tag di formato durante l'uso del filtro specificato. Ad esempio, se un driver supporta il ricampionamento di WAVE_FORMAT_PCM con il filtro specificato, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Driver supporta un filtro (modifica dei dati senza modificare uno degli attributi di formato). Ad esempio, se un driver supporta operazioni di volume o echo su WAVE_FORMAT_PCM, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Driver supporta input hardware, output o entrambi con il filtro specificato tramite un dispositivo waveform-audio. Un'applicazione deve usare la funzione acmMetrics con gli indici delle metriche ACM_METRIC_HARDWARE_WAVE_INPUT e ACM_METRIC_HARDWARE_WAVE_OUTPUT per ottenere gli identificatori di dispositivo waveform-audio associati al driver ACM di supporto.

Valore restituito

La funzione di callback deve restituire TRUE per continuare l'enumerazione o FALSE per arrestare l'enumerazione.

Commenti

La funzione acmFilterEnum restituirà MMSYSERR_NOERROR (zero) se non devono essere enumerati filtri. Inoltre, la funzione di callback non verrà chiamata.

Le funzioni seguenti non devono essere chiamate dall'interno della funzione callback: acmDriverAdd, acmDriverRemove e acmDriverPriority.

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

Vedi anche

Funzioni di compressione audio

Gestione compressione audio