Compartilhar via


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

O método GetIconPath recupera o caminho do ícone de exibição da sessão de áudio.

Sintaxe

HRESULT GetIconPath(
  [out] LPWSTR *pRetVal
);

Parâmetros

[out] pRetVal

Ponteiro para uma variável de ponteiro na qual o método grava o endereço de uma cadeia de caracteres largos terminada em nulo que especifica o caminho totalmente qualificado de um arquivo .ico, .dll ou .exe que contém o ícone. O método aloca o armazenamento para a cadeia de caracteres. O chamador é responsável por liberar o armazenamento, quando ele não é mais necessário, chamando a função CoTaskMemFree . Para obter informações sobre caminhos de ícone e CoTaskMemFree, consulte a documentação do SDK do Windows.

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.
E_OUTOFMEMORY
Sem memória.
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

Se um cliente não tiver chamado IAudioSessionControl::SetIconPath para definir o ícone de exibição, a cadeia de caracteres estará vazia. Se nenhum ícone especificado pelo cliente estiver disponível, o programa Sndvol usará o ícone da janela de aplicativo do cliente para rotular o controle de volume para a sessão de áudio.

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::SetIconPath