waveOutGetDevCaps-Funktion (mmeapi.h)
Die waveOutGetDevCaps-Funktion ruft die Funktionen eines bestimmten Waveform-Audioausgabegeräts ab.
Syntax
MMRESULT waveOutGetDevCaps(
UINT uDeviceID,
LPWAVEOUTCAPS pwoc,
UINT cbwoc
);
Parameter
uDeviceID
Bezeichner des Waveform-Audioausgabegeräts. Dabei kann es sich entweder um einen Gerätebezeichner oder um ein Handle eines Offenwellenform-Audioausgabegeräts handelt.
pwoc
Zeiger auf eine WAVEOUTCAPS-Struktur , die mit Informationen zu den Funktionen des Geräts gefüllt werden soll.
cbwoc
Größe der WAVEOUTCAPS-Struktur in Bytes.
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 die waveOutGetNumDevs-Funktion , um die Anzahl der im System vorhandenen Waveform-Audioausgabegerä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 cbwoc-Bytes (oder weniger) der Informationen werden an die Position kopiert, auf die pwoc verweist. Wenn cbwoc 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 |