Funzione waveOutPrepareHeader (mmeapi.h)

La funzione waveOutPrepareHeader prepara un blocco di dati audio waveform per la riproduzione.

Sintassi

MMRESULT waveOutPrepareHeader(
  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 preparare.

cbwh

Dimensioni, in byte, della struttura WAVEHDR .

Valore restituito

Restituisce MMSYSERR_NOERROR in caso di esito positivo o di 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.

Commenti

Impostare i membri lpData, dwBufferLength e dwFlags della struttura WAVEHDR prima di chiamare questa funzione. Impostare il membro dwFlags su zero.

I membri dwFlags, dwBufferLength e dwLoops della struttura WAVEHDR possono cambiare tra le chiamate a questa funzione e la funzione waveOutWrite . Se si modificano le dimensioni specificate da dwBufferLength prima della chiamata a waveOutWrite, il nuovo valore deve essere minore del valore preparato.

Se il metodo ha esito positivo, il flag WHDR_PREPARED viene impostato nel membro dwFlags della struttura WAVEHDR .

La preparazione di un'intestazione già preparata 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 Mmeapi.h, Windows.h)
Libreria	Winmm.lib
DLL	Winmm.dll

Vedi anche

Waveform Audio

Funzioni waveform