Método IAudioCaptureClient::GetNextPacketSize (audioclient.h)

  • Artigo

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
AUDCLNT_E_DEVICE_INVALIDATED
 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.
AUDCLNT_E_SERVICE_NOT_RUNNING
 O serviço de áudio do Windows não está em execução.
E_POINTER
 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 Interface

IAudioCaptureClient::GetBuffer

IAudioCaptureClient::ReleaseBuffer

IAudioClient::GetCurrentPadding