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 del 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 alcun attributo di 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.
Commenti
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, acmDriverRemove e 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 |