IAudioSessionControl2::GetSessionIdentifier method

The GetSessionIdentifier method retrieves the audio session identifier.

Syntax


HRESULT GetSessionIdentifier(
  [out] LPWSTR *pRetVal
);

Parameters

pRetVal [out]

Pointer to the address of a null-terminated, wide-character string that receives the audio session identifier. The string is allocated by this method and must be released by the caller by calling CoTaskMemFree. For information about CoTaskMemFree, see the Windows SDK documentation.

Return value

If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.

Return valueDescription
E_POINTER

pRetVal is NULL.

AUDCLNT_E_DEVICE_INVALIDATED

The audio session is disconnected on the default audio device.

 

Remarks

Each audio session is identified by an identifier string. This session identifier string is not unique across all instances. If there are two instances of the application playing, both instances will have the same session identifier. The identifier retrieved by GetSessionIdentifier is different from the session instance identifier, which is unique across all sessions. To get the session instance identifier, call IAudioSessionControl2::GetSessionInstanceIdentifier.

GetSessionIdentifier checks whether the session has been disconnected on the default device. It retrieves the identifier string that is cached by the audio client for the device. If the session identifier is not found, this method retrieves it from the audio engine.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Audiopolicy.h

IDL

Audiopolicy.idl

See also

IAudioSessionControl2

 

 

Show: