Share via

funzione waveOutGetPitch (mmeapi.h)

  • Articolo

La funzione waveOutGetPitch recupera l'impostazione di passo corrente per il dispositivo di output waveform-audio specificato.

Sintassi

MMRESULT waveOutGetPitch(
  HWAVEOUT hwo,
  LPDWORD  pdwPitch
);

Parametri

hwo

Gestire il dispositivo di output waveform-audio.

pdwPitch

Puntatore a una variabile da riempire con l'impostazione del moltiplicatore di passo corrente. Il moltiplicatore di passo indica la modifica corrente del passo dall'impostazione creata originale. Il moltiplicatore di passo deve essere un valore positivo.

Il moltiplicatore di passo viene specificato 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 di campo) 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 del passo non modifica la frequenza di riproduzione, la frequenza di campionamento o il tempo di riproduzione. Non tutti i dispositivi supportano le modifiche al passo. Per determinare se il dispositivo supporta il controllo del passo, usare il flag di WAVECAPS_PITCH 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 (includere Windows.h)
Libreria Winmm.lib
DLL Winmm.dll

Vedi anche

Waveform Audio

Funzioni waveform