Struttura ACMFORMATTAGDETAILS (msacm.h)
La struttura ACMFORMATTAGDETAILS dettaglia un tag di formato waveform-audio per un driver ACM.
Sintassi
typedef struct tACMFORMATTAGDETAILS {
DWORD cbStruct;
DWORD dwFormatTagIndex;
DWORD dwFormatTag;
DWORD cbFormatSize;
DWORD fdwSupport;
DWORD cStandardFormats;
char szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
} ACMFORMATTAGDETAILS, *PACMFORMATTAGDETAILS, *LPACMFORMATTAGDETAILS;
Members
cbStruct
Dimensioni, in byte, della struttura ACMFORMATTAGDETAILS . Questo membro deve essere inizializzato prima che un'applicazione chiami la funzione acmFormatTagDetails o acmFormatTagEnum . Le dimensioni specificate da questo membro devono essere sufficienti per contenere la struttura ACMFORMATTAGDETAILS di base. Quando la funzione acmFormatTagDetails restituisce , questo membro contiene le dimensioni effettive delle informazioni restituite. Le informazioni restituite non superano mai le dimensioni richieste.
dwFormatTagIndex
Indice del tag di formato per il quale verranno recuperati i dettagli. L'indice varia da zero a uno minore del numero di tag di formato supportati da un driver ACM. Il numero di tag di formato supportati da un driver è contenuto nella struttura ACMDRIVERDETAILS . Il membro dwFormatTagIndex viene usato solo quando si eseguono query sui dettagli del tag di formato su un driver per indice; in caso contrario, questo membro deve essere zero.
dwFormatTag
Tag di formato waveform-audio descritto dalla struttura ACMFORMATTAGDETAILS . Questo membro viene usato per l'input per i flag di query ACM_FORMATTAGDETAILSF_FORMATTAG e ACM_FORMATTAGDETAILSF_LARGESTSIZE. Se la funzione acmFormatTagDetails ha esito positivo, questo membro viene sempre restituito. Questo membro deve essere impostato su WAVE_FORMAT_UNKNOWN per tutti gli altri flag di query.
cbFormatSize
Dimensioni totali maggiori, in byte, di un formato waveform-audio del tipo dwFormatTag . Ad esempio, questo membro sarà 16 per WAVE_FORMAT_PCM e 50 per WAVE_FORMAT_ADPCM.
fdwSupport
Flag di supporto driver specifici del tag di formato. Questi flag sono identici alla struttura ACMDRIVERDETAILS . Questo membro può essere una combinazione dei valori seguenti e fare riferimento alle operazioni supportate dal driver con il tag di formato:
| Nome | Descrizione |
|---|---|
|
Il driver supporta le conversioni asincrone con il tag di formato specificato. |
|
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. |
|
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. |
|
Driver supporta un filtro (modifica dei dati senza modificare uno degli attributi di formato). Ad esempio, se un driver supporta operazioni di volume o echo sul tag di formato specificato, questo flag viene impostato. |
|
Il 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. |
cStandardFormats
Numero di formati standard del tipo dwFormatTag ; ovvero la combinazione di tutte le tariffe di esempio, i bit per esempio, i canali e così via. Questo valore può specificare tutti i formati supportati dal driver, ma non necessariamente.
szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS]
Stringa che descrive il tipo dwFormatTag . Se la funzione acmFormatTagDetails ha esito positivo, questa stringa viene sempre restituita.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | msacm.h |