Share via

Funzione waveOutSetPitch (mmeapi.h)

  • Articolo

La funzione waveOutSetPitch imposta l'inclinazione per il dispositivo di output audio waveform specificato.

Sintassi

MMRESULT waveOutSetPitch(
  HWAVEOUT hwo,
  DWORD    dwPitch
);

Parametri

hwo

Handle per il dispositivo di output audio waveform.

dwPitch

Nuova impostazione del moltiplicatore di inclinazione. Questa impostazione indica la modifica corrente del passo rispetto all'impostazione originale creata. Il moltiplicatore di passo deve essere un valore positivo.

Il moltiplicatore di inclinazione viene specificato 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 di passo) e un valore di 0x000F8000 specifica un moltiplicatore di 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 del passo non modifica la frequenza di riproduzione o la frequenza di campionamento, né modifica l'ora di riproduzione. Non tutti i dispositivi supportano le modifiche di passo. Per determinare se il dispositivo supporta il controllo pitch, usare il flag WAVECAPS_PITCH 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 (include Windows.h)
Libreria Winmm.lib
DLL Winmm.dll

Vedi anche

Waveform Audio

Funzioni waveform