waveInUnprepareHeader-Funktion (mmeapi.h)

  • Artikel

Die waveInUnprepareHeader-Funktion bereinigt die Vorbereitung, die von der waveInPrepareHeader-Funktion ausgeführt wird. Diese Funktion muss aufgerufen werden, nachdem der Gerätetreiber einen Puffer gefüllt und an die Anwendung zurückgibt. Sie müssen diese Funktion aufrufen, bevor Sie den Puffer freigeben.

Syntax

MMRESULT waveInUnprepareHeader(
  HWAVEIN   hwi,
  LPWAVEHDR pwh,
  UINT      cbwh
);

Parameter

hwi

Handle mit dem Waveform-Audio-Eingabegerät.

pwh

Zeiger auf eine WAVEHDR-Struktur , die den zu bereinigenden Puffer 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.
WAVERR_STILLPLAYING
 Der Puffer, auf den der pwh-Parameter verweist, befindet sich weiterhin in der Warteschlange.

Hinweise

Diese Funktion ergänzt die waveInPrepareHeader-Funktion .

Sie müssen diese Funktion aufrufen, bevor Sie den Puffer freigeben. Nachdem Sie einen Puffer mit der funktion waveInAddBuffer an den Gerätetreiber übergeben haben, müssen Sie warten, bis der Treiber mit dem Puffer fertig ist, bevor Sie waveInUnprepareHeader aufrufen. Das Aufheben der Vorbereitung eines Puffers, der nicht vorbereitet wurde, hat keine Auswirkung, und die Funktion gibt null zurück.

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