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

Obtém a contagem máxima de quadros com suporte por passagem de processamento.

Sintaxe

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

Parâmetros

[in] category

O AUDIO_STREAM_CATEGORY (audiosessiontypes.h) do fluxo de áudio para o qual o suporte é consultado.

[in] offloadEnabled

Um valor booliano que especifica se a contagem de quadros retornada deve ser calculada com o suporte de descarregamento de áudio considerado. Se esse sinalizador for definido como true, a contagem de quadros retornada será o que seria se o fluxo fosse ativado para o modo de descarregamento. No entanto, se esse sinalizador for definido como true, mas o ponto de extremidade de áudio não oferecer suporte ao modo de descarregamento, o sinalizador não terá efeito. Use ISpatialAudioClient2::IsOffloadCapable para marcar se houver suporte para o modo de descarregamento.

[in] objectFormat

Um ponteiro para uma estrutura WAVEFORMATEX (mmeapi.h) que especifica o formato do fluxo de áudio para o qual o suporte é consultado.

[out] frameCountPerBuffer

Recebe um ponteiro para um INT32 que indica a contagem máxima de quadros com suporte para o dispositivo de áudio e os parâmetros de entrada especificados.

Retornar valor

Um HRESULT, incluindo os valores a seguir.

Valor	Descrição
S_OK	Êxito
AUDCLNT_E_DEVICE_INVALIDATED	O dispositivo de áudio associado ao cliente de áudio foi invalidado.

Comentários

O valor retornado por esse método pode ser usado para alocar o buffer de origem. Esse valor será alterado se a cadência do ponto de extremidade for alterada. O chamador deve especificar os mesmos valores AUDIO_STREAM_CATEGORY e WAVEFORMATEX que serão usados ao criar o fluxo. O parâmetro offloadEnabled deverá ser definido como TRUE se o fluxo for criado com o sinalizador SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Build 22000
Cabeçalho	spatialaudioclient.h