Funzione di callback ACMFORMATENUMCB (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 definito dall'applicazione.
Sintassi
ACMFORMATENUMCB Acmformatenumcb;
BOOL Acmformatenumcb(
HACMDRIVERID hadid,
LPACMFORMATDETAILS pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parametri
hadid
Gestire l'identificatore del driver ACM.
pafd
Puntatore a una struttura ACMFORMATDETAILS contenente i dettagli del formato enumerati per un tag di formato.
dwInstance
Valore definito dall'applicazione specificato nella funzione acmFormatEnum .
fdwSupport
I flag di supporto driver specifici per il driver identificato dalla struttura ACMDRIVERDETAILS , ma sono specifici del formato enumerato. Questo parametro può essere una combinazione dei valori seguenti e indica quali operazioni supportano il driver per il tag di formato.
| 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 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 | Driver supporta un filtro (modifica dei dati senza modificare alcun attributo 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 | Driver supporta input hardware, output o entrambi i tag di formato specificati 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 acmFormatEnum restituirà MMSYSERR_NOERROR (zero) se non verranno enumerati formati. 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 |