waveOutGetDevCaps-Funktion (mmeapi.h)

  • Artikel

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
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 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

Weitere Informationen

Waveform-Audio

Wellenformfunktionen