Metodo IAudioSessionControl2::GetSessionInstanceIdentifier (audiopolicy.h)

Il metodo GetSessionInstanceIdentifier recupera l'identificatore dell'istanza della sessione audio.

Sintassi

HRESULT GetSessionInstanceIdentifier(
  [out] LPWSTR *pRetVal
);

Parametri

[out] pRetVal

Puntatore all'indirizzo di una stringa di caratteri wide con terminazione Null che riceve l'identificatore di una determinata istanza della 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 istanza della sessione audio è identificata da una stringa univoca. Questa stringa rappresenta una particolare istanza della sessione audio e, a differenza dell'identificatore di sessione, è univoca in tutte le istanze. Se sono presenti due istanze dell'applicazione in riproduzione, avranno identificatori di istanza di sessione diversi. L'identificatore recuperato da GetSessionInstanceIdentifier è diverso dall'identificatore di sessione, condiviso da tutte le istanze di sessione. Per ottenere l'identificatore di sessione, chiama IAudioSessionControl2::GetSessionIdentifier.

GetSessionInstanceIdentifier 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 dell'istanza di sessione non viene trovato, questo metodo lo recupera dal motore audio. Per un codice di esempio sul recupero di un identificatore di istanza di sessione, vedere Getting Ducking Events from a Communication Device .For example code about getting a session instance identifier, see Getting Ducking Events from a Communication Device.

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

Uso di un dispositivo di comunicazione