Método IMFSimpleAudioVolume::SetMasterVolume (mfidl.h)

  • Artigo

Define o nível de volume master.

Sintaxe

HRESULT SetMasterVolume(
  [in] float fLevel
);

Parâmetros

[in] fLevel

Nível de volume. O volume é expresso como um nível de atenuação, em que 0,0 indica silêncio e 1,0 indica volume completo (sem atenuação).

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
MF_E_NOT_INITIALIZED
 O renderizador de áudio não é inicializado.
MF_E_STREAMSINK_REMOVED
 O renderizador de áudio foi removido do pipeline.

Comentários

Eventos fora do aplicativo podem alterar o nível de volume master. Por exemplo, o usuário pode alterar o volume do programa de controle de volume do sistema (SndVol). Se um evento externo alterar o volume master, o renderizador de áudio enviará um evento MEAudioSessionVolumeChanged, que a Sessão de Mídia encaminha para o aplicativo.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mfuuid.lib

Confira também

IMFSimpleAudioVolume

Renderizador de Áudio de Streaming