Método ISpatialAudioObjectRenderStreamBase::GetService (spatialaudioclient.h)

  • Artigo

Obtém serviços adicionais do ISpatialAudioObjectRenderStream.

Sintaxe

HRESULT GetService(
  [in]  REFIID riid,
  [out] void   **service
);

Parâmetros

[in] riid

A ID da interface do serviço solicitado. O cliente deve definir esse parâmetro como um dos seguintes valores REFIID:

IID_IAudioClock

IID_IAudioClock2

IID_IAudioStreamVolume

[out] service

Ponteiro para uma variável de ponteiro na qual o método grava o endereço de uma instância da interface solicitada. Por meio desse método, o chamador obtém uma referência contada para a interface . O chamador é responsável por liberar a interface, quando ela não é mais necessária, chamando o método Release da interface. Se a chamada GetService falhar, *ppv será NULL.

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 ppv é NULL.
SPTLAUDCLNT_E_DESTROYED
 O ISpatialAudioClient associado ao fluxo de áudio espacial foi destruído.
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 indisponíveis para uso.
SPTLAUDCLNT_E_INTERNAL
 Ocorreu um erro interno.
AUDCLNT_E_UNSUPPORTED_FORMAT
 A mídia associada ao fluxo de áudio espacial usa um formato sem suporte.

Comentários

O método GetService dá suporte às seguintes interfaces de serviço:

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho spatialaudioclient.h

Confira também

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase