Método IAudioSessionControl::GetGroupingParam (audiopolicy.h)

O método GetGroupingParam recupera o parâmetro de agrupamento da sessão de áudio.

Sintaxe

HRESULT GetGroupingParam(
  [out] GUID *pRetVal
);

Parâmetros

[out] pRetVal

Ponteiro de saída para o GUID de parâmetro de agrupamento. Esse parâmetro deve ser um ponteiro válido, não NULL , para uma variável GUID alocada pelo chamador. O método grava o parâmetro de agrupamento nessa variável.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
E_POINTER
O parâmetro pRetVal é NULL.
AUDCLNT_E_DEVICE_INVALIDATED
O dispositivo de ponto de extremidade de áudio foi desconectado ou o hardware de áudio ou os recursos de hardware associados foram reconfigurados, desabilitados, removidos ou não estão disponíveis para uso.
AUDCLNT_E_SERVICE_NOT_RUNNING
O serviço de áudio do Windows não está em execução.

Comentários

Todas as sessões de áudio que têm o mesmo valor de parâmetro de agrupamento estão sob o controle do mesmo controle deslizante de nível de volume no programa de controle de volume do sistema, Sndvol. Para obter mais informações, consulte Parâmetros de agrupamento.

Um cliente pode chamar o método IAudioSessionControl::SetGroupingParam para alterar o parâmetro de agrupamento de uma sessão.

Se um cliente nunca tiver chamado SetGroupingParam para atribuir um parâmetro de agrupamento a uma sessão de áudio, o valor do parâmetro de agrupamento da sessão será GUID_NULL por padrão e uma chamada para GetGroupingParam recuperará esse valor. Um valor de parâmetro de agrupamento de GUID_NULL indica que a sessão não pertence a nenhum agrupamento. Nesse caso, a sessão tem seu próprio controle deslizante de nível de volume no programa Sndvol.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho audiopolicy.h

Confira também

IAudioSessionControl Interface

IAudioSessionControl::SetGroupingParam