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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | audiopolicy.h |