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

Article
03/02/2024

Obtient le nombre maximal de trames prises en charge par passe de traitement.

Syntaxe

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

Paramètres

[in] category

AUDIO_STREAM_CATEGORY (audiosessiontypes.h) du flux audio pour lequel la prise en charge est interrogée.

[in] offloadEnabled

Valeur booléenne spécifiant si le nombre de trames retournées doit être calculé avec prise en charge du déchargement audio. Si cet indicateur est défini sur true, le nombre d’images retourné est ce qu’il serait si le flux est activé pour le mode de déchargement. Toutefois, si cet indicateur a la valeur true, mais que le point de terminaison audio ne prend pas en charge le mode de déchargement, l’indicateur n’a aucun effet. Utilisez ISpatialAudioClient2 ::IsOffloadCapable pour case activée si le mode de déchargement est pris en charge.

[in] objectFormat

Pointeur vers une structure WAVEFORMATEX (mmeapi.h) spécifiant le format du flux audio pour lequel la prise en charge est interrogée.

[out] frameCountPerBuffer

Reçoit un pointeur vers un INT32 indiquant le nombre maximal d’images prises en charge pour le périphérique audio et les paramètres d’entrée spécifiés.

Valeur retournée

HRESULT incluant les valeurs suivantes.

Valeur	Description
S_OK	Succès
AUDCLNT_E_DEVICE_INVALIDATED	Le périphérique audio associé au client audio a été invalidé.

Remarques

La valeur retournée par cette méthode peut être utilisée pour allouer la mémoire tampon source. Cette valeur change si la cadence du point de terminaison change. L’appelant doit spécifier les mêmes valeurs AUDIO_STREAM_CATEGORY et WAVEFORMATEX qui seront utilisées lors de la création du flux. Le paramètre offloadEnabled doit avoir la valeur TRUE si le flux est créé avec l’indicateur SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Build 22000
En-tête	spatialaudioclient.h

Partager via