Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A função waveOutGetPlaybackRate recupera a taxa de reprodução atual para o dispositivo de saída waveform-audio especificado.
Sintaxe
MMRESULT waveOutGetPlaybackRate(
HWAVEOUT hwo,
LPDWORD pdwRate
);
Parâmetros
hwo
Identificador para o dispositivo de saída waveform-audio.
pdwRate
Ponteiro para uma variável a ser preenchida com a taxa de reprodução atual. A configuração de taxa de reprodução é um multiplicador que indica a alteração atual na taxa de reprodução da configuração original criada. O multiplicador de taxa de reprodução deve ser um valor positivo.
A taxa é especificada como um valor de ponto fixo. A palavra de alta ordem da variável contém a parte inteira com sinal do número e a palavra de ordem baixa contém a parte fracionária. Um valor de 0x8000 na palavra de baixa ordem representa metade e 0x4000 representa um quarto. Por exemplo, o valor 0x00010000 especifica um multiplicador de 1,0 (sem alteração de taxa de reprodução) e um valor de 0x000F8000 especifica um multiplicador de 15,5.
Retornar valor
Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.
| Código de retorno | Descrição |
|---|---|
|
O identificador de dispositivo especificado é inválido. |
|
Nenhum driver de dispositivo está presente. |
|
Não é possível alocar ou bloquear memória. |
|
Não há suporte para a função . |
Comentários
Alterar a taxa de reprodução não altera a taxa de amostragem, mas altera o tempo de reprodução. Nem todos os dispositivos dão suporte a alterações na taxa de reprodução. Para determinar se um dispositivo dá suporte a alterações na taxa de reprodução, use o sinalizador WAVECAPS_PLAYBACKRATE para testar o membro dwSupport da estrutura WAVEOUTCAPS (preenchido pela função waveOutGetDevCaps ).
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | mmeapi.h (inclua Windows.h) |
| Biblioteca | Winmm.lib |
| DLL | Winmm.dll |