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 waveInUnprepareHeader limpa a preparação executada pela função waveInPrepareHeader . Essa função deve ser chamada depois que o driver do dispositivo preencher um buffer e o retornar ao aplicativo. Você deve chamar essa função antes de liberar o buffer.
Sintaxe
MMRESULT waveInUnprepareHeader(
HWAVEIN hwi,
LPWAVEHDR pwh,
UINT cbwh
);
Parâmetros
hwi
Manipule para o dispositivo de entrada waveform-audio.
pwh
Ponteiro para uma estrutura WAVEHDR que identifica o buffer a ser limpo.
cbwh
Tamanho, em bytes, da estrutura WAVEHDR .
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. |
|
O buffer apontado pelo parâmetro pwh ainda está na fila. |
Comentários
Essa função complementa a função waveInPrepareHeader .
Você deve chamar essa função antes de liberar o buffer. Depois de passar um buffer para o driver do dispositivo com a função waveInAddBuffer , você deve aguardar até que o driver seja concluído com o buffer antes de chamar waveInUnprepareHeader. Despreparar um buffer que não foi preparado não tem efeito e a função retorna zero.
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 |