Compartilhar via

Função XAudio2Create (xaudio2.h)

Cria um novo objeto XAudio2 e retorna um ponteiro para sua interface IXAudio2 .

Sintaxe

HRESULT XAudio2Create(
  [out] IXAudio2          **ppXAudio2,
  [in]  UINT32            Flags,
  [in]  XAUDIO2_PROCESSOR XAudio2Processor
);

Parâmetros

[out] ppXAudio2

Se a operação for bem-sucedida, retornará um ponteiro para um objeto IXAudio2 .

[in] Flags

Sinalizadores que especificam o comportamento do objeto IXAudio2 . O valor desse parâmetro deve ser 0.

[in] XAudio2Processor

Um valor tipo XAUDIO2_PROCESSOR que especifica qual CPU usar. Se vários bits forem especificados, o sistema criará um thread de trabalho separado para cada processador.

XAUDIO2_PROCESSOR valor padrão é XAUDIO2_DEFAULT_PROCESSOR.

Aviso Se você especificar XAUDIO2_ANY_PROCESSOR, o sistema usará todos os processadores do dispositivo e, conforme observado acima, criará um thread de trabalho para cada processador.
 
Nota A especificação de um processador geralmente deve ser evitada porque pode interferir na capacidade do agendador de agendar threads efetivamente entre processadores. Em vez disso, passe o valor XAUDIO2_DEFAULT_PROCESSOR (veja abaixo).
 
O valor de XAUDIO2_DEFAULT_PROCESSOR especial faz com que o XAudio2 use seu processador padrão.

Valor de retorno

Retorna S_OK se bem-sucedido, caso contrário, um código de erro. Consulte códigos de erro XAudio2 para obter descrições de códigos de erro específicos do XAudio2.

Observações

As versões do SDK do DirectX do XAUDIO2 suportavam um sinalizador XAUDIO2_DEBUG_ENGINE para selecionar entre a versão e a versão 'marcada'. Esse sinalizador não tem suporte ou é definido na versão do Windows 8 do XAUDIO2.

Nota Nenhuma versão do SDK do DirectX contém a biblioteca de importação xaudio2.lib. As versões do SDK do DirectX usam COM para criar um novo objeto XAudio2 .
 

Requisitos da plataforma

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

Windows Phone 8.1: Essa API tem suporte.

Requirements

Requirement Value
da Plataforma de Destino Windows
Header xaudio2.h
Library Xaudio2.lib
de DLL Windows.Media.Audio.dll

Consulte também

Como criar um grafo de processamento de áudio básico

Funções XAudio2

  • Last updated on