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 |
|---|---|
|
L'handle del dispositivo specificato non è valido. |
|
Non è presente alcun driver di dispositivo. |
|
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 |