waveInAddBuffer-Funktion (mmeapi.h)

  • Artikel

Die waveInAddBuffer-Funktion sendet einen Eingabepuffer an das angegebene Waveform-Audio-Eingabegerät. Wenn der Puffer gefüllt ist, wird die Anwendung benachrichtigt.

Syntax

MMRESULT waveInAddBuffer(
  HWAVEIN   hwi,
  LPWAVEHDR pwh,
  UINT      cbwh
);

Parameter

hwi

Handle mit dem Waveform-Audio-Eingabegerät.

pwh

Zeiger auf eine WAVEHDR-Struktur , die den Puffer identifiziert.

cbwh

Größe der WAVEHDR-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_INVALHANDLE
 Das angegebene Gerätehandle ist ungültig.
MMSYSERR_NODRIVER
 Es ist kein Gerätetreiber vorhanden.
MMSYSERR_NOMEM
 Speicher kann nicht zugeordnet oder gesperrt werden.
WAVERR_UNPREPARED
 Der Puffer, auf den der pwh-Parameter verweist, wurde nicht vorbereitet.

Hinweise

Wenn der Puffer gefüllt ist, wird das WHDR_DONE Bit im dwFlags-Element der WAVEHDR-Struktur festgelegt.

Der Puffer muss mit der waveInPrepareHeader-Funktion vorbereitet werden, bevor er an diese Funktion übergeben wird.

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ßlich Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

Waveform Audio

Wellenformfunktionen