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 de 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 de XAUDIO2_DEFAULT_PROCESSOR (veja abaixo).
 
O valor de XAUDIO2_DEFAULT_PROCESSOR especial faz com que o XAudio2 use seu processador padrão.

Retornar valor

Retorna S_OK se tiver êxito, 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.

Comentários

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'. Não há suporte para esse sinalizador nem definido na versão 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 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 xaudio2.h
Biblioteca Xaudio2.lib
DLL Windows.Media.Audio.dll

Confira também

Como: Compilar um gráfico de processamento de áudio básico

Funções XAudio2