Método ISpatialAudioObjectForHrtf::SetDirectivity (spatialaudiohrtf.h)

Define o modelo de directividade de áudio espacial para o ISpatialAudioObjectForHrtf.

Sintaxe

HRESULT SetDirectivity(
  SpatialAudioHrtfDirectivityUnion *directivity
);

Parâmetros

directivity

O modelo de directividade de áudio espacial. Esse valor pode ser uma das seguintes estruturas:

• SpatialAudioHrtfDirectivity
• SpatialAudioHrtfDirectivityCardioid
• SpatialAudioHrtfDirectivityCone

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
SPTLAUDCLNT_E_OUT_OF_ORDER	ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects não foi chamado antes da chamada para SetDirectivity.
SPTLAUDCLNT_E_RESOURCES_INVALIDATED	SetEndOfStream foi chamado explicitamente ou implicitamente em uma passagem de processamento de áudio anterior. SetEndOfStream será chamado implicitamente pelo sistema se GetBuffer não for chamado dentro de uma passagem de processamento de áudio (entre chamadas para ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects).

Comentários

A estrutura SpatialAudioHrtfDirectivity representa um modelo omnidirecional que pode ser interpolado linearmente com um modelo cardioide ou cone.

Se SetDirectivity não for chamado, o tipo padrão de SpatialAudioHrtfDirectivity_OmniDirectional será usado sem interpolação.

Requisitos

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

Confira também

ISpatialAudioObjectForHrtf