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 |
|---|---|
|
pRetVal es NULL. |
|
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 |