Struttura WAVEOUTCAPSA (mmeapi.h)
La struttura WAVEOUTCAPS descrive le funzionalità di un dispositivo di output audio waveform.
Sintassi
typedef struct tagWAVEOUTCAPSA {
WORD wMid;
WORD wPid;
MMVERSION vDriverVersion;
CHAR szPname[MAXPNAMELEN];
DWORD dwFormats;
WORD wChannels;
WORD wReserved1;
DWORD dwSupport;
} WAVEOUTCAPSA, *PWAVEOUTCAPSA, *NPWAVEOUTCAPSA, *LPWAVEOUTCAPSA;
Members
wMid
Identificatore del produttore per il driver di dispositivo per il dispositivo. Gli identificatori del produttore sono definiti in Manufacturer e Product Identifiers.
wPid
Identificatore del prodotto per il dispositivo. Gli identificatori di prodotto sono definiti in Manufacturer e Product Identifiers.
vDriverVersion
Numero di versione del driver di dispositivo per il dispositivo. Il byte di ordine elevato è il numero di versione principale e il byte di ordine basso è il numero di versione secondaria.
szPname[MAXPNAMELEN]
Nome del prodotto in una stringa con terminazione Null.
dwFormats
Formati standard supportati. Può essere una combinazione dei seguenti elementi:
| Formato | Descrizione |
|---|---|
| WAVE_FORMAT_1M08 | 11,025 kHz, mono, 8 bit |
| WAVE_FORMAT_1M16 | 11,025 kHz, mono, 16 bit |
| WAVE_FORMAT_1S08 | 11,025 kHz, stereo, 8 bit |
| WAVE_FORMAT_1S16 | 11,025 kHz, stereo, 16 bit |
| WAVE_FORMAT_2M08 | 22,05 kHz, mono, 8 bit |
| WAVE_FORMAT_2M16 | 22,05 kHz, mono, 16 bit |
| WAVE_FORMAT_2S08 | 22,05 kHz, stereo, 8 bit |
| WAVE_FORMAT_2S16 | 22,05 kHz, stereo, 16 bit |
| WAVE_FORMAT_4M08 | 44,1 kHz, mono, 8 bit |
| WAVE_FORMAT_4M16 | 44,1 kHz, mono, 16 bit |
| WAVE_FORMAT_4S08 | 44,1 kHz, stereo, 8 bit |
| WAVE_FORMAT_4S16 | 44,1 kHz, stereo, 16 bit |
| WAVE_FORMAT_96M08 | 96 kHz, mono, 8 bit |
| WAVE_FORMAT_96M16 | 96 kHz, mono, 16 bit |
| WAVE_FORMAT_96S08 | 96 kHz, stereo, 8 bit |
| WAVE_FORMAT_96S16 | 96 kHz, stereo, 16 bit |
wChannels
Numero che specifica se il dispositivo supporta l'output mono (1) o stereo (2).
wReserved1
dwSupport
Funzionalità facoltative supportate dal dispositivo. Vengono definiti i valori seguenti:
| Flag | Descrizione |
|---|---|
| WAVECAPS_LRVOLUME | Supporta un controllo del volume separato da sinistra e destra. |
| WAVECAPS_PITCH | Supporta il controllo passo. |
| WAVECAPS_PLAYBACKRATE | Supporta il controllo della velocità di riproduzione. |
| WAVECAPS_SYNC | Il driver è sincrono e blocca durante la riproduzione di un buffer. |
| WAVECAPS_VOLUME | Supporta il controllo volume. |
| WAVECAPS_SAMPLEACCURATE | Restituisce informazioni sulla posizione accurata del campione. |
Commenti
Se un dispositivo supporta le modifiche al volume, il flag WAVECAPS_VOLUME verrà impostato per il membro dwSupport . Se un dispositivo supporta modifiche di volume separate nei canali sinistro e destro, sia il WAVECAPS_VOLUME che i flag WAVECAPS_LRVOLUME verranno impostati per questo membro.
Nota
L'intestazione mmeapi.h definisce WAVEOUTCAPS 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] |
| Intestazione | mmeapi.h (include Windows.h) |