Struttura WAVEOUTCAPSW (mmeapi.h)
La struttura WAVEOUTCAPS descrive le funzionalità di un dispositivo di output waveform-audio.
Sintassi
typedef struct tagWAVEOUTCAPSW {
WORD wMid;
WORD wPid;
MMVERSION vDriverVersion;
WCHAR szPname[MAXPNAMELEN];
DWORD dwFormats;
WORD wChannels;
WORD wReserved1;
DWORD dwSupport;
} WAVEOUTCAPSW, *PWAVEOUTCAPSW, *NPWAVEOUTCAPSW, *LPWAVEOUTCAPSW;
Members
wMid
Identificatore del produttore per il driver di dispositivo per il dispositivo. Gli identificatori del produttore sono definiti in Identificatori produttore e prodotto.
wPid
Identificatore del prodotto per il dispositivo. Gli identificatori del prodotto sono definiti in Identificatori di prodotto e produttore.
vDriverVersion
Numero di versione del driver di dispositivo per il dispositivo. Il byte ad ordine elevato è il numero di versione principale e il byte a basso ordine è 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, a 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. I valori seguenti sono definiti:
| Flag | Descrizione |
|---|---|
| WAVECAPS_LRVOLUME | Supporta un controllo del volume a sinistra e destro separato. |
| WAVECAPS_PITCH | Supporta il controllo del passo. |
| WAVECAPS_PLAYBACKRATE | Supporta il controllo della frequenza 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 di esempio. |
Commenti
Se un dispositivo supporta le modifiche al volume, il flag di WAVECAPS_VOLUME verrà impostato per il membro dwSupport . Se un dispositivo supporta modifiche di volume separate nei canali sinistro e destro, sia i WAVECAPS_VOLUME che i flag di 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | mmeapi.h (includere Windows.h) |