WAVEOUTCAPSW-Struktur (mmeapi.h)
Die WAVEOUTCAPS- Struktur beschreibt die Funktionen eines Waveform-Audioausgabegeräts.
Syntax
typedef struct tagWAVEOUTCAPSW {
WORD wMid;
WORD wPid;
MMVERSION vDriverVersion;
WCHAR szPname[MAXPNAMELEN];
DWORD dwFormats;
WORD wChannels;
WORD wReserved1;
DWORD dwSupport;
} WAVEOUTCAPSW, *PWAVEOUTCAPSW, *NPWAVEOUTCAPSW, *LPWAVEOUTCAPSW;
Angehörige
wMid
Herstellerbezeichner für den Gerätetreiber für das Gerät. Hersteller-IDs werden in Hersteller- und Produkt-IDsdefiniert.
wPid
Produkt-ID für das Gerät. Produkt-IDs werden in Hersteller- und Produkt-IDsdefiniert.
vDriverVersion
Versionsnummer des Gerätetreibers für das Gerät. Das Byte mit hoher Reihenfolge ist die Hauptversionsnummer, und das Byte mit niedriger Reihenfolge ist die Nebenversionsnummer.
szPname[MAXPNAMELEN]
Produktname in einer mit Null beendeten Zeichenfolge.
dwFormats
Unterstützte Standardformate. Dies kann eine Kombination aus folgendem 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 mono (1) oder Stereoausgabe (2) unterstützt.
wReserved1
dwSupport
Optionale Funktionen, die vom Gerät unterstützt werden. Die folgenden Werte sind definiert:
| Flagge | Beschreibung |
|---|---|
| WAVECAPS_LRVOLUME | Unterstützt separate linke und rechte Lautstärkeregelung. |
| WAVECAPS_PITCH | Unterstützt die Neigungssteuerung. |
| WAVECAPS_PLAYBACKRATE | Unterstützt die Wiedergaberate-Steuerung. |
| WAVECAPS_SYNC | Der Treiber ist synchron und blockiert während der Wiedergabe eines Puffers. |
| WAVECAPS_VOLUME | Unterstützt die Lautstärkeregelung. |
| WAVECAPS_SAMPLEACCURATE | Gibt Beispielgenaue Positionsinformationen zurück. |
Bemerkungen
Wenn ein Gerät Volumeänderungen unterstützt, wird das WAVECAPS_VOLUME Flag für das dwSupport Member festgelegt. Wenn ein Gerät separate Volumeänderungen auf den linken und rechten Kanälen unterstützt, werden sowohl die WAVECAPS_VOLUME als auch die WAVECAPS_LRVOLUME Flags für dieses Element festgelegt.
Anmerkung
Der mmeapi.h-Header definiert WAVEOUTCAPS als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Header- | mmeapi.h (enthalten Windows.h) |