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)

Weitere Informationen

Waveform-Audio

Wellenformstrukturen