funzione waveOutGetPitch (mmeapi.h)
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 |
|---|---|
|
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, 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 |