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

Die Parameter

uDeviceID

Bezeichner des Waveform-Audioausgabegeräts. Es kann sich um einen Gerätebezeichner oder ein Handle eines offenen Waveform-Audioausgabegeräts handeln.

pwoc

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

cbwoc

Größe der WAVEOUTCAPS-Struktur in Bytes.

Rückgabewert

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

Bemerkungen

Verwenden Sie die WaveOutGetNumDevs-Funktion , um die Anzahl der im System vorhandenen Waveform-Audioausgabegerä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 cbwoc Bytes (oder weniger) von Informationen werden an die Position kopiert, auf die von pwoc verwiesen wird. Wenn cbwoc null ist, wird nichts kopiert, und die Funktion gibt Null zurück.

Anforderungen

Siehe auch

Waveform Audio

Waveform-Funktionen