waveOutWrite-Funktion (mmeapi.h)
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 |
|---|---|
|
Das angegebene Gerätehandle ist ungültig. |
|
Es ist kein Gerätetreiber vorhanden. |
|
Speicher kann nicht zugeordnet oder gesperrt werden. |
|
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 |