Struttura WAVEOUTCAPSW (mmeapi.h)
La struttura WAVEOUTCAPS descrive le funzionalità di un dispositivo di output audio waveform.
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;
Membri
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 secondario.
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. Sono definiti i valori seguenti:
| Bandiera | Descrizione |
|---|---|
| WAVECAPS_LRVOLUME | Supporta controlli del volume separati da sinistra e destra. |
| WAVECAPS_PITCH | Supporta il controllo passo. |
| WAVECAPS_PLAYBACKRATE | Supporta il controllo della frequenza di riproduzione. |
| WAVECAPS_SYNC | Il driver è sincrono e bloccherà durante la riproduzione di un buffer. |
| WAVECAPS_VOLUME | Supporta il controllo del volume. |
| WAVECAPS_SAMPLEACCURATE | Restituisce informazioni sulla posizione accurate del campione. |
Osservazioni
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, verranno impostati sia il WAVECAPS_VOLUME che i flag WAVECAPS_LRVOLUME 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 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] |
| intestazione |
mmeapi.h (include Windows.h) |
Vedere anche
audio waveform