Compartilhar via

Função X3DAudioInitialize (x3daudio.h)

  • Artigo

Define todas as constantes de áudio 3D globais.

Sintaxe

X3DAUDIO_API_(HRESULT) X3DAudioInitialize(
  [in]  UINT32          SpeakerChannelMask,
  [in]  FLOAT32         SpeedOfSound,
  [out] X3DAUDIO_HANDLE Instance
);

Parâmetros

[in] SpeakerChannelMask

Atribuição de canais para posições de locutor. Esse valor não deve ser zero. O único valor permitido no Xbox 360 é SPEAKER_XBOX.

[in] SpeedOfSound

Velocidade do som, em unidades mundiais definidas pelo usuário por segundo. Use esse valor somente para cálculos doppler. Ele deve ser maior ou igual a FLT_MIN.

[out] Instance

Identificador de instância de áudio 3D. Use esse identificador ao chamar X3DAudioCalculate.

Retornar valor

Essa função não retorna um valor.

Comentários

X3DAUDIO_HANDLE é uma estrutura de dados opaca. Como o sistema operacional não aloca nenhum armazenamento adicional para o identificador de instância de áudio 3D, você não precisa liberá-lo ou fechá-lo.

Requisitos de plataforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); SDK do DirectX (XAudio 2.7)

Windows Phone 8.1: há suporte para essa API.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho x3daudio.h
Biblioteca XAudio2.lib

Confira também

Funções