WAVEOUTCAPSA-Struktur (mmeapi.h)

  • Artikel

Die WAVEOUTCAPS-Struktur beschreibt die Funktionen eines Waveform-Audioausgabegeräts.

Syntax

typedef struct tagWAVEOUTCAPSA {
  WORD      wMid;
  WORD      wPid;
  MMVERSION vDriverVersion;
  CHAR      szPname[MAXPNAMELEN];
  DWORD     dwFormats;
  WORD      wChannels;
  WORD      wReserved1;
  DWORD     dwSupport;
} WAVEOUTCAPSA, *PWAVEOUTCAPSA, *NPWAVEOUTCAPSA, *LPWAVEOUTCAPSA;

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.

wReserved1

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.

Hinweis

Der mmeapi.h-Header definiert WAVEOUTCAPS als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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

   
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