waveOutWrite-Funktion (mmeapi.h)

  • Artikel

Die waveOutWrite-Funktion sendet einen Datenblock an das angegebene Waveform-Audioausgabegerät.

Syntax

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

Parameter

hwo

Handle mit dem Waveform-Audioausgabegerät.

pwh

Zeiger auf eine WAVEHDR-Struktur , die Informationen zum Datenblock enthält.

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 Datenblock, auf den der pwh-Parameter verweist, wurde nicht vorbereitet.

Hinweise

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

Der Puffer muss mit der waveOutPrepareHeader-Funktion vorbereitet werden, bevor er an waveOutWrite übergeben wird. Sofern das Gerät nicht durch Aufrufen der waveOutPause-Funktion angehalten wird, beginnt die Wiedergabe, wenn der erste Datenblock an das Gerät gesendet wird.

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

Weitere Informationen

Waveform Audio

Wellenformfunktionen