Método ISpatialAudioClient2::GetMaxFrameCountForCategory (spatialaudioclient.h)

Obtiene el número máximo de fotogramas admitidos por paso de procesamiento.

Sintaxis

HRESULT GetMaxFrameCountForCategory(
  [in]  AUDIO_STREAM_CATEGORY category,
  [in]  BOOL                  offloadEnabled,
  [in]  const WAVEFORMATEX    *objectFormat,
  [out] UINT32                *frameCountPerBuffer
);

Parámetros

[in] category

El AUDIO_STREAM_CATEGORY (audiosessiontypes.h) de la secuencia de audio para la que se consulta la compatibilidad.

[in] offloadEnabled

Valor booleano que especifica si el recuento de fotogramas devuelto se debe calcular con compatibilidad con la descarga de audio que se tiene en cuenta. Si esta marca se establece en true, el recuento de fotogramas devuelto es lo que sería si la secuencia se activa para el modo de descarga. Sin embargo, si esta marca se establece en true, pero el punto de conexión de audio no admite el modo de descarga, la marca no tiene ningún efecto. Use ISpatialAudioClient2::IsOffloadCapable para comprobar si se admite el modo de descarga.

[in] objectFormat

Puntero a una estructura WAVEFORMATEX (mmeapi.h) que especifica el formato de la secuencia de audio para la que se consulta la compatibilidad.

[out] frameCountPerBuffer

Recibe un puntero a un INT32 que indica el número máximo de fotogramas admitidos para el dispositivo de audio y los parámetros de entrada especificados.

Valor devuelto

HrESULT, incluidos los valores siguientes.

Valor	Descripción
S_OK	Correcto
AUDCLNT_E_DEVICE_INVALIDATED	El dispositivo de audio asociado al cliente de audio se ha invalidado.

Comentarios

El valor devuelto por este método se puede usar para asignar el búfer de origen. Este valor cambiará si cambia la cadencia del punto de conexión. El autor de la llamada debe especificar los mismos valores AUDIO_STREAM_CATEGORY y WAVEFORMATEX que se usarán al crear la secuencia. El parámetro offloadEnabled debe establecerse en TRUE si la secuencia se creará con la marca SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD .

Requisitos

Requisito	Value
Cliente mínimo compatible	Compilación 22000 de Windows
Encabezado	spatialaudioclient.h