waveInGetDevCaps-Funktion (mmeapi.h)

Die WaveInGetDevCaps-Funktion ruft die Funktionen eines bestimmten Waveform-Audioeingabegeräts ab.

Syntax

MMRESULT waveInGetDevCaps(
  UINT         uDeviceID,
  LPWAVEINCAPS pwic,
  UINT         cbwic
);

Die Parameter

uDeviceID

Bezeichner des Waveform-Audioeingabegeräts. Dabei kann es sich entweder um einen Gerätebezeichner oder einen Handle eines offenen Waveform-Audio-Eingabegeräts handeln.

pwic

Zeiger auf eine WAVEINCAPS-Struktur , die mit Informationen über die Funktionen des Geräts gefüllt werden soll.

cbwic

Größe der WAVEINCAPS-Struktur in Bytes.

Rückgabewert

Gibt MMSYSERR_NOERROR zurück, wenn dies erfolgreich ist oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:

Bemerkungen

Verwenden Sie diese Funktion, um die Anzahl der im System vorhandenen Waveform-Audioeingabegeräte zu ermitteln. Wenn der durch den Parameter "uDeviceID " angegebene Wert ein Gerätebezeichner ist, kann er von Null bis 1 kleiner als die Anzahl der vorhandenen Geräte variieren. Die WAVE_MAPPER Konstante kann auch als Gerätebezeichner verwendet werden. Nur cbwic Bytes (oder weniger) von Informationen werden an die Position kopiert, auf die durch pwic verwiesen wird. Wenn cbwic null ist, wird nichts kopiert, und die Funktion gibt Null zurück.

Anforderungen

Siehe auch

Waveform AudioWaveform-Funktionen