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 |