waveOutUnprepareHeader-Funktion (mmeapi.h)
Die waveOutUnprepareHeader-Funktion bereinigt die Vorbereitung, die von der waveOutPrepareHeader-Funktion ausgeführt wird. Diese Funktion muss aufgerufen werden, nachdem der Gerätetreiber mit einem Datenblock abgeschlossen wurde. Sie müssen diese Funktion aufrufen, bevor Sie den Puffer freigeben.
Syntax
MMRESULT waveOutUnprepareHeader(
HWAVEOUT hwo,
LPWAVEHDR pwh,
UINT cbwh
);
Parameter
hwo
Handle für das Waveform-Audio-Ausgabegerät.
pwh
Zeiger auf eine WAVEHDR-Struktur , die den zu bereinigenden 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 |
|---|---|
|
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, befindet sich weiterhin in der Warteschlange. |
Hinweise
Diese Funktion ergänzt waveOutPrepareHeader. Sie müssen diese Funktion aufrufen, bevor Sie den Puffer freigeben. Nachdem Sie einen Puffer mit der waveOutWrite-Funktion an den Gerätetreiber übergeben haben, müssen Sie warten, bis der Treiber mit dem Puffer fertig ist, bevor Sie waveOutUnprepareHeader aufrufen.
Das Aufheben der Vorbereitung eines Puffers, der nicht vorbereitet wurde, 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ßen von Windows.h) |
| Bibliothek | Winmm.lib |
| DLL | Winmm.dll |