Funzione di callback ACMFORMATTAGENUMCBW (msacm.h)

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

Sintassi

ACMFORMATTAGENUMCBW Acmformattagenumcbw;

BOOL Acmformattagenumcbw(
  HACMDRIVERID hadid,
  LPACMFORMATTAGDETAILSW paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parametri

hadid

Handle per l'identificatore del driver ACM.

paftd

Puntatore a una struttura ACMFORMATTAGDETAILS che contiene i dettagli del tag di formato enumerato.

dwInstance

Valore definito dall'applicazione specificato nella funzione acmFormatTagEnum.

fdwSupport

Flag di supporto driver specifici per il tag di formato. Questi flag sono identici alla struttura ACMDRIVERDETAILS . Questo parametro può essere una combinazione dei valori seguenti e indica le operazioni supportate dal driver con il tag di formato.

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 in cui uno dei tag è il tag di formato specificato. Ad esempio, se un driver supporta la compressione da WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Il driver supporta la conversione tra due formati diversi del tag di formato specificato. Ad esempio, se un driver supporta il ricampionamento di WAVE_FORMAT_PCM, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Il driver supporta un filtro (modifica dei dati senza modificare gli attributi del formato). Ad esempio, se un driver supporta operazioni di volume o echo sul tag di formato specificato, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Il driver supporta l'input hardware, l'output o entrambi i tag di formato specificati tramite un dispositivo audio waveform. Un'applicazione deve usare acmMetrics con gli indici delle metriche ACM_METRIC_HARDWARE_WAVE_INPUT e ACM_METRIC_HARDWARE_WAVE_OUTPUT per ottenere gli identificatori di 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.

Osservazioni

La funzione acmFormatTagEnum restituirà MMSYSERR_NOERROR (zero) se non devono essere enumerati tag di formato. 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 ACMFORMATTAGENUMCB 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

Vedere anche

funzioni di compressione audio

gestione compressione audio