Metodo IAudioSessionManager2::GetSessionEnumerator (audiopolicy.h)

Il metodo GetSessionEnumerator ottiene un puntatore all'oggetto enumeratore sessione audio.

Sintassi

HRESULT GetSessionEnumerator(
  [out] IAudioSessionEnumerator **SessionEnum
);

Parametri

[out] SessionEnum

Riceve un puntatore all'interfaccia IAudioSessionEnumerator dell'oggetto enumeratore sessione che il client può usare per enumerare le sessioni audio nel dispositivo audio. Tramite questo metodo, il chiamante ottiene un riferimento conteggiato all'interfaccia. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK.

Commenti

La gestione sessione gestisce una raccolta di sessioni audio attive nel dispositivo audio eseguendo query sul motore audio. GetSessionEnumerator crea un controllo sessione per ogni sessione della raccolta. Per ottenere un riferimento all'interfaccia IAudioSessionControl della sessione nell'insieme enumerato, l'applicazione deve chiamare IAudioSessionEnumerator::GetSession. Per un esempio di codice, vedere Interfaccia IAudioSessionEnumerator.

L'enumeratore di sessione potrebbe non essere a conoscenza delle nuove sessioni segnalate tramite IAudioSessionNotification. Quindi, se un'applicazione si basa esclusivamente sull'enumeratore di sessione per ottenere tutte le sessioni per un endpoint audio, i risultati potrebbero non essere accurati. Per risolvere questo problema, l'applicazione deve mantenere manualmente un elenco. Per altre informazioni, vedere IAudioSessionEnumerator.

Requisiti

Vedi anche

IAudioSessionManager2