Funzione di callback ACMFILTERENUMCBA (msacm.h)
La funzione acmFilterEnumCallback specifica una funzione di callback usata con la funzione acmFilterEnum. Il nome acmFilterEnumCallback è un segnaposto per un nome di funzione definito dall'applicazione.
Sintassi
ACMFILTERENUMCBA Acmfilterenumcba;
BOOL Acmfilterenumcba(
HACMDRIVERID hadid,
LPACMFILTERDETAILSA pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parametri
hadid
Handle per l'identificatore del driver ACM.
pafd
Puntatore a una struttura ACMFILTERDETAILS
dwInstance
Valore definito dall'applicazione specificato in acmFilterEnum.
fdwSupport
Flag di supporto driver specifici per il driver identificato da struttura ACMDRIVERDETAILS, ma sono specifici del filtro da enumerare. Questo parametro può essere una combinazione dei valori seguenti e identifica le operazioni supportate dal driver per 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 filtro specificato. Ad esempio, se un driver supporta la compressione da WAVE_FORMAT_PCM a WAVE_FORMAT_ADPCM con il 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 filtro specificato. Ad esempio, se un driver supporta il ricampionamento di WAVE_FORMAT_PCM con il filtro specificato, 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 su WAVE_FORMAT_PCM, questo flag viene impostato. |
| ACMDRIVERDETAILS_SUPPORTF_HARDWARE | Il driver supporta l'input hardware, l'output o entrambi con il filtro specificato tramite un dispositivo audio waveform. Un'applicazione deve usare la funzione di 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 acmFilterEnum restituirà MMSYSERR_NOERROR (zero) se non devono essere enumerati filtri. 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 ACMFILTERENUMCB 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 |