funzione waveOutWrite (mmeapi.h)
La funzione waveOutWrite invia un blocco di dati al dispositivo di output waveform-audio specificato.
Sintassi
MMRESULT waveOutWrite(
HWAVEOUT hwo,
LPWAVEHDR pwh,
UINT cbwh
);
Parametri
hwo
Gestire il dispositivo di output waveform-audio.
pwh
Puntatore a una struttura WAVEHDR contenente informazioni sul blocco di dati.
cbwh
Dimensioni, in byte, della struttura WAVEHDR .
Valore restituito
Restituisce MMSYSERR_NOERROR se ha esito positivo o un 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. |
|
Il blocco di dati a cui fa riferimento il parametro pwh non è stato preparato. |
Commenti
Al termine del buffer, il bit di WHDR_DONE viene impostato nel membro dwFlags della struttura WAVEHDR .
Il buffer deve essere preparato con la funzione waveOutPrepareHeader prima di passare a waveOutWrite. A meno che il dispositivo non venga sospeso chiamando la funzione waveOutPause , la riproduzione inizia quando il primo blocco di dati viene inviato al dispositivo.
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 (includere Windows.h) |
| Libreria | Winmm.lib |
| DLL | Winmm.dll |