waveInGetDevCaps-Funktion (mmeapi.h)
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 |
|---|---|
|
Der angegebene Gerätebezeichner liegt außerhalb des Bereichs. |
|
Es ist kein Gerätetreiber vorhanden. |
|
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 |