Share via

funzione waveOutUnprepareHeader (mmeapi.h)

  • Articolo

La funzione waveOutUnprepareHeader pulisce la preparazione eseguita dalla funzione waveOutPrepareHeader . Questa funzione deve essere chiamata dopo il completamento del driver di dispositivo con un blocco di dati. È necessario chiamare questa funzione prima di liberare il buffer.

Sintassi

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

Parametri

hwo

Handle per il dispositivo di output audio waveform.

pwh

Puntatore a una struttura WAVEHDR che identifica il blocco di dati da pulire.

cbwh

Dimensioni, in byte, della struttura WAVEHDR .

Valore restituito

Restituisce MMSYSERR_NOERROR se l'esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito Descrizione
MMSYSERR_INVALHANDLE
 L'handle del dispositivo specificato non è valido.
MMSYSERR_NODRIVER
 Non è presente alcun driver di dispositivo.
MMSYSERR_NOMEM
 Impossibile allocare o bloccare la memoria.
WAVERR_STILLPLAYING
 Il blocco di dati a cui punta il parametro pwh è ancora nella coda.

Commenti

Questa funzione integra waveOutPrepareHeader. È necessario chiamare questa funzione prima di liberare il buffer. Dopo aver passato un buffer al driver di dispositivo con la funzione waveOutWrite , è necessario attendere il completamento del driver con il buffer prima di chiamare waveOutUnprepareHeader.

La preparazione di un buffer che non è stato preparato non ha alcun effetto e la funzione restituisce zero.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mmeapi.h (include Windows.h)
Libreria Winmm.lib
DLL Winmm.dll

Vedi anche

Waveform Audio

Funzioni waveform