Funzione di callback ACMDRIVERENUMCB (msacm.h)
La funzione acmDriverEnumCallback specifica una funzione di callback usata con la funzione acmDriverEnum . Il nome acmDriverEnumCallback è un segnaposto per un nome di funzione definito dall'applicazione.
Sintassi
ACMDRIVERENUMCB Acmdriverenumcb;
BOOL Acmdriverenumcb(
HACMDRIVERID hadid,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parametri
hadid
Handle per un identificatore del driver ACM.
dwInstance
Valore definito dall'applicazione specificato in acmDriverEnum.
fdwSupport
Flag di supporto driver specifici del driver specificato dalla struttura ACMDRIVERDETAILS . Questo parametro può essere una combinazione dei valori seguenti.
| Valore | Significato |
|---|---|
| ACMDRIVERDETAILS_SUPPORTF_ASYNC | Il driver supporta le conversioni asincrone. |
| ACMDRIVERDETAILS_SUPPORTF_CODEC | Il driver supporta la conversione tra due tag di formato diversi. 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 dello stesso tag di formato. Ad esempio, se un driver supporta il ricampionamento di WAVE_FORMAT_PCM, questo flag viene impostato. |
| ACMDRIVERDETAILS_SUPPORTF_DISABLED | Il driver è stato disabilitato. Un'applicazione deve specificare il flag ACM_DRIVERENUMF_DISABLED con acmDriverEnum per includere i driver disabilitati nell'enumerazione . |
| 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 su WAVE_FORMAT_PCM, questo flag viene impostato. |
Valore restituito
La funzione di callback deve restituire TRUE per continuare l'enumerazione o FALSE per arrestare l'enumerazione.
Commenti
La funzione acmDriverEnum restituirà MMSYSERR_NOERROR (zero) se non sono installati driver ACM. 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.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |