Compartir a través de

Función XAudio2Create (xaudio2.h)

  • Artículo

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

Sintaxis

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 XAUDIO2_PROCESSOR con tipo 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 los 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.

Comentarios

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: se admite esta API.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado xaudio2.h
Library Xaudio2.lib
Archivo DLL Windows.Media.Audio.dll

Consulte también

Cómo: crear un gráfico de procesamiento de audio básico

Funciones XAudio2