waveOutPrepareHeader-Funktion (mmeapi.h)

  • Artikel

Die waveOutPrepareHeader-Funktion bereitet einen Waveform-Audiodatenblock für die Wiedergabe vor.

Syntax

MMRESULT waveOutPrepareHeader(
  HWAVEOUT  hwo,
  LPWAVEHDR pwh,
  UINT      cbwh
);

Parameter

hwo

Handle mit dem Waveform-Audioausgabegerät.

pwh

Zeiger auf eine WAVEHDR-Struktur , die den vorzubereitenden Datenblock 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.

Hinweise

Legen Sie die Elemente lpData, dwBufferLength und dwFlags der WAVEHDR-Struktur fest, bevor Sie diese Funktion aufrufen. Legen Sie den dwFlags-Member auf 0 fest.

Die DwFlags-, dwBufferLength- und dwLoops-Member der WAVEHDR-Struktur können zwischen Aufrufen dieser Funktion und der waveOutWrite-Funktion geändert werden. Wenn Sie die von dwBufferLength angegebene Größe vor dem Aufruf von waveOutWrite ändern, muss der neue Wert kleiner als der vorbereitete Wert sein.

Wenn die Methode erfolgreich ist, wird das WHDR_PREPARED-Flag im dwFlags-Element der WAVEHDR-Struktur festgelegt.

Das Vorbereiten eines bereits vorbereiteten Headers hat keine Auswirkung, und die Funktion gibt null zurück.

Anforderungen

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

Weitere Informationen

Waveform Audio

Wellenformfunktionen