Share via


Metodo IAudioSessionEvents::OnStateChanged (audiopolicy.h)

Il metodo OnStateChanged notifica al client che lo stato dell'attività di flusso della sessione è cambiato.

Sintassi

HRESULT OnStateChanged(
  [in] AudioSessionState NewState
);

Parametri

[in] NewState

Nuovo stato sessione. Il valore di questo parametro è uno dei valori di enumerazione AudioSessionState seguenti:

AudioSessionStateActive

AudioSessionStateInactive

AudioSessionStateExpired

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.

Commenti

Un client non può generare un evento session-state-change. Il sistema è sempre l'origine di questo tipo di evento. Pertanto, a differenza di altri metodi IAudioSessionEvents , questo metodo non fornisce un parametro di contesto.

Il sistema modifica lo stato di una sessione da inattivo a attivo al momento in cui un client apre il primo flusso nella sessione. Un client apre un flusso chiamando il metodo IAudioClient::Initialize . Il sistema modifica lo stato della sessione da attivo a inattivo al momento in cui un client chiude l'ultimo flusso nella sessione. Il client che rilascia l'ultimo riferimento a un oggetto IAudioClient chiude il flusso associato all'oggetto .

Per un esempio di codice che implementa i metodi nell'interfaccia IAudioSessionEvents , vedere Eventi sessione audio.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione audiopolicy.h

Vedi anche

Interfaccia IAudioClient

IAudioClient::Initialize

Interfaccia IAudioSessionEvents