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

El método GetNextPacketSize recupera el número de fotogramas del siguiente paquete de datos en el búfer del punto de conexión de captura.

Sintaxis

HRESULT GetNextPacketSize(
  [out] UINT32 *pNumFramesInNextPacket
);

Parámetros

[out] pNumFramesInNextPacket

Puntero a una variable UINT32 en la que el método escribe el recuento de fotogramas (el número de fotogramas de audio en el siguiente paquete de captura).

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto	Descripción
AUDCLNT_E_DEVICE_INVALIDATED	El dispositivo de punto de conexión de audio se ha desconectado o el hardware de audio o los recursos de hardware asociados se han reconfigurado, deshabilitado, quitado o no están disponibles para su uso.
AUDCLNT_E_SERVICE_NOT_RUNNING	El servicio de audio de Windows no se está ejecutando.
E_POINTER	El parámetro pNumFramesInNextPacket es NULL.

Comentarios

Use este método solo con secuencias en modo compartido. No funciona con secuencias en modo exclusivo.

Antes de llamar al método IAudioCaptureClient::GetBuffer para recuperar el siguiente paquete de datos, el cliente puede llamar a GetNextPacketSize para recuperar el número de fotogramas de audio en el siguiente paquete. El recuento notificado por GetNextPacketSize coincide con el recuento recuperado en la llamada GetBuffer (a través del parámetro de salida pNumFramesToRead ) que sigue a la llamada GetNextPacketSize .

Un paquete siempre consta de un número entero de fotogramas de audio.

Se debe llamar a GetNextPacketSize en el mismo subproceso que las llamadas al método GetBuffer e IAudioCaptureClient::ReleaseBuffer que obtienen y liberan los paquetes en el búfer del punto de conexión de captura.

Para obtener un ejemplo de código que usa el método GetNextPacketSize, consulte Captura de un Stream.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	audioclient.h

Consulte también

IAudioCaptureClient (interfaz)

IAudioCaptureClient::GetBuffer

IAudioCaptureClient::ReleaseBuffer

IAudioClient::GetCurrentPadding