Funzione waveOutSetPlaybackRate (mmeapi.h)
La funzione waveOutSetPlaybackRate imposta la frequenza di riproduzione per il dispositivo di output audio waveform specificato.
Sintassi
MMRESULT waveOutSetPlaybackRate(
HWAVEOUT hwo,
DWORD dwRate
);
Parametri
hwo
Handle per il dispositivo di output audio waveform.
dwRate
Nuova impostazione della frequenza di riproduzione. Questa impostazione è un moltiplicatore che indica la modifica corrente della frequenza di riproduzione rispetto all'impostazione originale creata. Il moltiplicatore della frequenza di riproduzione deve essere un valore positivo.
La frequenza viene specificata come valore a virgola fissa. La parola di ordine elevato contiene la parte con segno integer del numero e la parola in ordine basso contiene la parte frazionaria. Un valore di 0x8000 nella parola di ordine basso rappresenta una metà e 0x4000 rappresenta un quarto. Ad esempio, il valore 0x00010000 specifica un moltiplicatore di 1,0 (nessuna modifica della frequenza di riproduzione) e un valore di 0x000F8000 specifica un moltiplicatore pari a 15,5.
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 |
|---|---|
|
L'handle del dispositivo specificato non è valido. |
|
Non è presente alcun driver di dispositivo. |
|
Impossibile allocare o bloccare la memoria. |
|
La funzione non è supportata. |
Commenti
La modifica della frequenza di riproduzione non modifica la frequenza di campionamento, ma modifica il tempo di riproduzione. Non tutti i dispositivi supportano le modifiche della frequenza di riproduzione. Per determinare se un dispositivo supporta le modifiche della frequenza di riproduzione, usare il flag WAVECAPS_PLAYBACKRATE per testare il membro dwSupport della struttura WAVEOUTCAPS (riempito dalla funzione waveOutGetDevCaps ).
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 |