waveInGetDevCaps-Funktion (mmeapi.h)

  • Artikel

Die waveInGetDevCaps-Funktion ruft die Funktionen eines bestimmten Waveform-Audio-Eingabegeräts ab.

Syntax

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

Parameter

uDeviceID

Bezeichner des Waveform-Audioausgabegeräts. Dabei kann es sich entweder um einen Gerätebezeichner oder um ein Handle eines Offenwellenform-Audioeingabegeräts handelt.

pwic

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

cbwic

Größe der WAVEINCAPS-Struktur in Byte.

Rückgabewert

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

Rückgabecode Beschreibung
MMSYSERR_BADDEVICEID
 Der angegebene Gerätebezeichner liegt außerhalb des Bereichs.
MMSYSERR_NODRIVER
 Es ist kein Gerätetreiber vorhanden.
MMSYSERR_NOMEM
 Speicher kann nicht zugeordnet oder gesperrt werden.

Hinweise

Verwenden Sie diese Funktion, um die Anzahl der im System vorhandenen Wellenform-Audioeingabegeräte zu bestimmen. Wenn der durch den uDeviceID-Parameter angegebene Wert ein Gerätebezeichner ist, kann er von 0 bis 1 unter der 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 pwic verweist. Wenn cbwic null ist, wird nichts kopiert, und die Funktion gibt null zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mmeapi.h (Einschließen von Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

Waveform-Audio

Wellenformfunktionen