Método IAudioSessionControl2::GetSessionIdentifier (audiopolicy.h)

El método GetSessionIdentifier recupera el identificador de sesión de audio.

Sintaxis

HRESULT GetSessionIdentifier(
  [out] LPWSTR *pRetVal
);

Parámetros

[out] pRetVal

Puntero a la dirección de una cadena de caracteres anchos terminada en NULL que recibe el identificador de la sesión de audio. El autor de la llamada asigna la cadena mediante este método y debe liberarla llamando a CoTaskMemFree. Para obtener información sobre CoTaskMemFree, consulte la documentación de Windows SDK.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Valor devuelto	Descripción
E_POINTER	pRetVal es NULL.
AUDCLNT_E_DEVICE_INVALIDATED	La sesión de audio se desconecta en el dispositivo de audio predeterminado.

Comentarios

Cada sesión de audio se identifica mediante una cadena de identificador. Esta cadena de identificador de sesión no es única en todas las instancias. Si hay dos instancias de la aplicación que se reproducen, ambas instancias tendrán el mismo identificador de sesión. El identificador recuperado por GetSessionIdentifier es diferente del identificador de instancia de sesión, que es único en todas las sesiones. Para obtener el identificador de instancia de sesión, llame a IAudioSessionControl2::GetSessionInstanceIdentifier.

GetSessionIdentifier comprueba si la sesión se ha desconectado en el dispositivo predeterminado. Recupera la cadena de identificador almacenada en caché por el cliente de audio para el dispositivo. Si no se encuentra el identificador de sesión, este método lo recupera del motor de audio.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	audiopolicy.h

Consulte también

IAudioSessionControl2