Funzione waveOutSetPlaybackRate (mmeapi.h)

  • Articolo

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
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.
MMSYSERR_NOTSUPPORTED
 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

Vedi anche

Waveform Audio

Funzioni waveform