Metodo IAudioSessionControl2::GetSessionIdentifier (audiopolicy.h)

Il metodo GetSessionIdentifier recupera l'identificatore di sessione audio.

Sintassi

HRESULT GetSessionIdentifier(
  [out] LPWSTR *pRetVal
);

Parametri

[out] pRetVal

Puntatore all'indirizzo di una stringa di caratteri wide con terminazione Null che riceve l'identificatore di sessione audio. La stringa viene allocata da questo metodo e deve essere rilasciata dal chiamante chiamando CoTaskMemFree. Per informazioni su CoTaskMemFree, vedere la documentazione di Windows SDK.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Valore restituito Descrizione
E_POINTER
pRetVal è NULL.
AUDCLNT_E_DEVICE_INVALIDATED
La sessione audio è disconnessa nel dispositivo audio predefinito.

Commenti

Ogni sessione audio è identificata da una stringa di identificatore. Questa stringa dell'identificatore di sessione non è univoca in tutte le istanze. Se sono presenti due istanze dell'applicazione in riproduzione, entrambe le istanze avranno lo stesso identificatore di sessione. L'identificatore recuperato da GetSessionIdentifier è diverso dall'identificatore dell'istanza di sessione, univoco in tutte le sessioni. Per ottenere l'identificatore dell'istanza di sessione, chiamare IAudioSessionControl2::GetSessionInstanceIdentifier.

GetSessionIdentifier controlla se la sessione è stata disconnessa nel dispositivo predefinito. Recupera la stringa di identificatore memorizzata nella cache dal client audio per il dispositivo. Se l'identificatore di sessione non viene trovato, questo metodo lo recupera dal motore audio.

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

Vedi anche

IAudioSessionControl2