waveInPrepareHeader-Funktion (mmeapi.h)

  • Artikel

Die waveInPrepareHeader-Funktion bereitet einen Puffer für die Waveform-Audioeingabe vor.

Syntax

MMRESULT waveInPrepareHeader(
  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, der vorbereitet werden soll.

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.

Hinweise

Die Elemente lpData, dwBufferLength und dwFlags der WAVEHDR-Struktur müssen vor dem Aufrufen dieser Funktion festgelegt werden (dwFlags muss 0 sein).

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