Méthode ISpatialAudioObjectBase ::IsActive (spatialaudioclient.h)

Obtient une valeur booléenne indiquant si ISpatialAudioObject est valide.

Syntaxe

HRESULT IsActive(
  [out] BOOL *isActive
);

Paramètres

[out] isActive

TRUE si l’objet audio est actuellement valide ; sinon, FALSE.

Valeur retournée

Si la méthode réussit, retourne S_OK.

Remarques

Si cette valeur est false, vous devez appeler Release pour rendre la ressource d’objet audio disponible à l’avenir.

IsActive aura la valeur false une fois que SetEndOfStream est appelé implicitement ou explicitement. SetEndOfStream est appelé implicitement par le système si GetBuffer n’est pas appelé dans une passe de traitement audio (entre les appels à ISpatialAudioObjectRenderStream ::BeginUpdatingAudioObjects et ISpatialAudioObjectSstream ::EndUpdatingAudioObjectss).

Le moteur de rendu désactive également l’objet audio, en définissant IsActive sur false, lorsque les ressources d’objet audio deviennent indisponibles. Dans ce cas, une notification est envoyée via ISpatialAudioObjectRenderStreamNotify avant la désactivation de l’objet. La valeur renvoyée dans le paramètre availableDynamicObjectCount à ISpatialAudioObjectRenderStream ::BeginUpdatingAudioObjects indique le nombre d’objets qui seront traités pour chaque passage.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	spatialaudioclient.h

Voir aussi

ISpatialAudioObject

ISpatialAudioObjectBase