WAVEOUTCAPS-Struktur (mmeapi.h)
Die WAVEOUTCAPS-Struktur beschreibt die Funktionen eines Waveform-Audioausgabegeräts.
Syntax
typedef struct waveoutcaps_tag {
WORD wMid;
WORD wPid;
VERSION vDriverVersion;
char szPname[MAXPNAMELEN];
DWORD dwFormats;
WORD wChannels;
DWORD dwSupport;
} WAVEOUTCAPS, *PWAVEOUTCAPS, *NPWAVEOUTCAPS, *LPWAVEOUTCAPS;
Members
wMid
Hersteller-ID für den Gerätetreiber für das Gerät. Hersteller-IDs werden unter Hersteller- und Produkt-IDs definiert.
wPid
Produkt-ID für das Gerät. Produktbezeichner werden unter Hersteller- und Produkt-IDs definiert.
vDriverVersion
Versionsnummer des Gerätetreibers für das Gerät. Das Byte mit hoher Ordnung ist die Hauptversionsnummer, und das Byte mit niedriger Ordnung ist die Nebenversionsnummer.
szPname[MAXPNAMELEN]
Produktname in einer Zeichenfolge mit NULL-Beendigung.
dwFormats
Unterstützte Standardformate. Dies kann eine Kombination aus folgenden Komponenten sein:
| Format | BESCHREIBUNG |
|---|---|
| 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
Zahl, die angibt, ob das Gerät den Mono- (1)- oder Stereo-Ausgang (2) unterstützt.
dwSupport
Optionale Funktionen, die vom Gerät unterstützt werden. Die folgenden Werte werden definiert:
| Flag | Beschreibung |
|---|---|
| WAVECAPS_LRVOLUME | Unterstützt eine separate Lautstärkeregelung für links und rechts. |
| WAVECAPS_PITCH | Unterstützt die Tonhöhensteuerung. |
| WAVECAPS_PLAYBACKRATE | Unterstützt die Steuerung der Wiedergaberate. |
| WAVECAPS_SYNC | Der Treiber ist synchron und blockiert während der Wiedergabe eines Puffers. |
| WAVECAPS_VOLUME | Unterstützt die Lautstärkeregelung. |
| WAVECAPS_SAMPLEACCURATE | Gibt stichprobengenaue Positionsinformationen zurück. |
Hinweise
Wenn ein Gerät Volumeänderungen unterstützt, wird das flag WAVECAPS_VOLUME für das dwSupport-Element festgelegt. Wenn ein Gerät separate Volumeänderungen auf dem linken und rechten Kanal unterstützt, werden sowohl die WAVECAPS_VOLUME- als auch die WAVECAPS_LRVOLUME-Flags für dieses Element festgelegt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | mmeapi.h (Einschließen von Windows.h) |