Método IAudioCaptureClient::GetNextPacketSize (audioclient.h)
O método GetNextPacketSize recupera o número de quadros no próximo pacote de dados no buffer do ponto de extremidade de captura.
Sintaxe
HRESULT GetNextPacketSize(
[out] UINT32 *pNumFramesInNextPacket
);
Parâmetros
[out] pNumFramesInNextPacket
Ponteiro para uma variável UINT32 na qual o método grava a contagem de quadros (o número de quadros de áudio no próximo pacote de captura).
Retornar valor
Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
O dispositivo de ponto de extremidade de áudio foi desconectado ou o hardware de áudio ou os recursos de hardware associados foram reconfigurados, desabilitados, removidos ou não estão disponíveis para uso. |
|
O serviço de áudio do Windows não está em execução. |
|
O parâmetro pNumFramesInNextPacket é NULL. |
Comentários
Use esse método somente com fluxos de modo compartilhado. Ele não funciona com fluxos de modo exclusivo.
Antes de chamar o método IAudioCaptureClient::GetBuffer para recuperar o próximo pacote de dados, o cliente pode chamar GetNextPacketSize para recuperar o número de quadros de áudio no próximo pacote. A contagem relatada por GetNextPacketSize corresponde à contagem recuperada na chamada GetBuffer (por meio do parâmetro de saída pNumFramesToRead ) que segue a chamada GetNextPacketSize .
Um pacote sempre consiste em um número integral de quadros de áudio.
GetNextPacketSize deve ser chamado no mesmo thread que as chamadas do método GetBuffer e IAudioCaptureClient::ReleaseBuffer que obtêm e liberam os pacotes no buffer do ponto de extremidade de captura.
Para obter um exemplo de código que usa o método GetNextPacketSize, consulte Capturando um Stream.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | audioclient.h |
Confira também
IAudioCaptureClient::GetBuffer