Compartir a través de

Función XAudio2Create (xaudio2.h)

Crea un nuevo objeto XAudio2 y devuelve un puntero a su interfaz IXAudio2 .

Syntax

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

Parámetros

[out] ppXAudio2

Si la operación se realiza correctamente, devuelve un puntero a un objeto IXAudio2 .

[in] Flags

Marcas que especifican el comportamiento del objeto IXAudio2 . El valor de este parámetro debe ser 0.

[in] XAudio2Processor

Valor con tipo XAUDIO2_PROCESSOR que especifica qué CPU se va a usar. Si se especifican varios bits, el sistema creará un subproceso de trabajo independiente para cada procesador.

XAUDIO2_PROCESSOR valor predeterminado es XAUDIO2_DEFAULT_PROCESSOR.

Advertencia Si especifica XAUDIO2_ANY_PROCESSOR, el sistema usará todos los procesadores del dispositivo y, como se indicó anteriormente, creará un subproceso de trabajo para cada procesador.
 
Nota Por lo general, se debe evitar especificar un procesador porque puede interferir con la capacidad del programador de programar subprocesos de forma eficaz entre procesadores. En su lugar, pase el valor de XAUDIO2_DEFAULT_PROCESSOR (consulte a continuación).
 
El valor de XAUDIO2_DEFAULT_PROCESSOR especial hace que XAudio2 use su procesador predeterminado.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente, de lo contrario, un código de error. Consulte Códigos de error XAudio2 para obtener descripciones de códigos de error específicos de XAudio2.

Observaciones

Las versiones del SDK de DirectX de XAUDIO2 admiten una marca XAUDIO2_DEBUG_ENGINE para seleccionar entre la versión y la versión "activada". Esta marca no se admite ni se define en la versión de Windows 8 de XAUDIO2.

Nota Ninguna versión del SDK de DirectX contiene la biblioteca de importación xaudio2.lib. Las versiones del SDK de DirectX usan COM para crear un nuevo objeto XAudio2 .
 

Requisitos de la plataforma

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

Windows Phone 8.1: Esta API es compatible.

Requisitos

Requirement Importancia
de la plataforma de destino de Windows
Header xaudio2.h
Library Xaudio2.lib
DLL de Windows.Media.Audio.dll

Consulte también

Cómo: Crear un grafo básico de procesamiento de audio

Funciones XAudio2

  • Last updated on