Freigeben über


waveOutGetDevCapsA-Funktion (mmeapi.h)

Die waveOutGetDevCapsA-Funktion ruft die Funktionen eines bestimmten Waveform-Audioausgabegeräts ab. Dies ist die ANSI-Version der Funktion.

Syntax

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

cbwoc

Größe der WAVEOUTCAPSA-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 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

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

Siehe auch

Waveform Audio

Waveform-Funktionen