Funzione waveOutSetPitch (mmeapi.h)
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 |
|---|---|
|
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 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 |