Funzione di callback ACMFILTERTAGENUMCB (msacm.h)

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

Sintassi

ACMFILTERTAGENUMCB Acmfiltertagenumcb;

BOOL Acmfiltertagenumcb(
  HACMDRIVERID hadid,
  LPACMFILTERTAGDETAILS paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parametri

hadid

Handle per l'identificatore del driver ACM.

paftd

Puntatore a una struttura ACMFILTERTAGDETAILS che contiene i dettagli del tag di filtro enumerato.

dwInstance

Valore definito dall'applicazione specificato in acmFilterTagEnum.

fdwSupport

Flag di supporto driver specifici per la struttura ACMDRIVERDETAILS dell'identificatore del driver. Questo parametro può essere una combinazione dei valori seguenti e identifica le operazioni supportate dal driver con il tag di filtro.

Valore	Significato
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Il driver supporta 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 tag di filtro specificato. Ad esempio, se un driver supporta la compressione da WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM con il tag di 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 tag di filtro specificato. Ad esempio, se un driver supporta il ricampionamento di WAVE_FORMAT_PCM con il tag di filtro specificato, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Il driver supporta un filtro (modifica dei dati senza modificare alcun attributo di formato). Ad esempio, se un driver supporta operazioni di volume o echo su WAVE_FORMAT_PCM, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Il driver supporta l'input hardware, l'output o entrambi con il tag di filtro specificato tramite un dispositivo audio waveform. 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 del dispositivo audio waveform 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 acmFilterTagEnum restituisceMMSYSERR_NOERROR (zero) se non devono essere enumerati tag di filtro. 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

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