Funzione di callback ACMFORMATENUMCBA (msacm.h)

La funzione acmFormatEnumCallback specifica una funzione di callback usata con la funzione acmFormatEnum. Il nome acmFormatEnumCallback è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

ACMFORMATENUMCBA Acmformatenumcba;

BOOL Acmformatenumcba(
  HACMDRIVERID hadid,
  LPACMFORMATDETAILSA pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parametri

hadid

Handle per l'identificatore del driver ACM.

pafd

Puntatore a una struttura ACMFORMATDETAILS che contiene i dettagli del formato enumerato per un tag di formato.

dwInstance

Valore definito dall'applicazione specificato nella funzione acmFormatEnum.

fdwSupport

I flag di supporto dei driver specifici per il driver identificato da struttura ACMDRIVERDETAILS, ma sono specifici del formato che viene enumerato. Questo parametro può essere una combinazione dei valori seguenti e indica le operazioni supportate dal driver per 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 per il formato specificato. Ad esempio, se un driver supporta la compressione da WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM con il formato 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 formato specificato. Ad esempio, se un driver supporta il ricampionamento di WAVE_FORMAT_PCM al formato specificato, questo flag viene impostato.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Il driver supporta un filtro (modifica dei dati senza modificare gli attributi di formato) con il formato specificato. 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 i tag di formato specificati 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.

Osservazioni

La funzione acmFormatEnum restituirà MMSYSERR_NOERROR (zero) se non devono essere enumerati formati. 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 ACMFORMATENUMCB 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