Metodo ISpatialAudioObjectBase::IsActive (spatialaudioclient.h)
Ottiene un valore booleano che indica se ISpatialAudioObject è valido.
Sintassi
HRESULT IsActive(
[out] BOOL *isActive
);
Parametri
[out] isActive
TRUE se l'oggetto audio è attualmente valido; in caso contrario, FALSE.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK.
Commenti
Se questo valore è false, è necessario chiamare Release per rendere disponibile la risorsa dell'oggetto audio in futuro.
IsActive verrà impostato su false dopo che SetEndOfStream viene chiamato in modo implicito o esplicito. SetEndOfStream viene chiamato in modo implicito dal sistema se GetBuffer non viene chiamato all'interno di un passaggio di elaborazione audio (tra le chiamate a ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStream::EndUpdatingAudioObjects).
Il motore di rendering disattiva anche l'oggetto audio, impostando IsActive su false, quando le risorse dell'oggetto audio non sono disponibili. In questo caso, una notifica viene inviata tramite ISpatialAudioObjectRenderStreamNotify prima che l'oggetto venga disattivato. Il valore restituito nel parametro availableDynamicObjectCount a ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects indica il numero di oggetti elaborati per ogni passaggio.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | spatialaudioclient.h |