Freigeben über


waveInGetDevCapsA-Funktion (mmeapi.h)

Die waveInGetDevCapsA-Funktion ruft die Funktionen eines bestimmten Waveform-Audio-Eingabegeräts ab. Dies ist die ANSI-Version dieser Funktion.

Syntax

MMRESULT waveInGetDevCapsA(
  UINT_PTR      uDeviceID,
  LPWAVEINCAPSA 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 WAVEINCAPSA-Struktur , die mit Informationen über die Funktionen des Geräts gefüllt werden soll.

cbwic

Größe der WAVEINCAPSA-Struktur in Bytes.

Rückgabewert

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

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

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

Anforderung Wert
Mindestens unterstützter Client Windows 2000 Professional
Mindestanforderungen für unterstützte Server Windows 2000 Server
Header mmeapi.h
Library Winmm.lib
DLL Winmm.dll