Share via

funzione waveOutGetPlaybackRate (mmeapi.h)

  • Articolo

La funzione waveOutGetPlaybackRate recupera la frequenza di riproduzione corrente per il dispositivo di output waveform-audio specificato.

Sintassi

MMRESULT waveOutGetPlaybackRate(
  HWAVEOUT hwo,
  LPDWORD  pdwRate
);

Parametri

hwo

Gestire il dispositivo di output waveform-audio.

pdwRate

Puntatore a una variabile da riempire con la frequenza di riproduzione corrente. L'impostazione della frequenza di riproduzione è un moltiplicatore che indica la modifica corrente della frequenza di riproduzione dall'impostazione creata originale. Il moltiplicatore della frequenza di riproduzione deve essere un valore positivo.

La frequenza viene specificata come valore a virgola fissa. La parola con ordine elevato della variabile contiene la parte intero con segno del numero e la parola a basso ordine contiene la parte frazionaria. Un valore di 0x8000 nella parola a basso ordine rappresenta una metà e 0x4000 rappresenta un quarto. Ad esempio, il valore 0x00010000 specifica un moltiplicatore pari a 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 ha 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 di WAVECAPS_PLAYBACKRATE per testare il membro dwSupport della struttura WAVEOUTCAPS (riempito dalla funzione waveOutGetDevCaps ).

Requisiti

Requisito Valore
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

Vedi anche

Waveform Audio

Funzioni waveform