Funzione XAudio2Create (xaudio2.h)

Articolo
03/08/2023

Crea un nuovo oggetto XAudio2 e restituisce un puntatore all'interfaccia IXAudio2 .

Sintassi

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

Parametri

[out] ppXAudio2

Se l'operazione ha esito positivo, restituisce un puntatore a un oggetto IXAudio2 .

[in] Flags

Flag che specificano il comportamento dell'oggetto IXAudio2 . Il valore di questo parametro deve essere 0.

[in] XAudio2Processor

Valore tipizzato XAUDIO2_PROCESSOR che specifica la CPU da usare. Se vengono specificati più bit, il sistema creerà un thread di lavoro separato per ogni processore.

XAUDIO2_PROCESSOR valore predefinito è XAUDIO2_DEFAULT_PROCESSOR.

Avviso Se si specifica XAUDIO2_ANY_PROCESSOR, il sistema userà tutti i processori del dispositivo e, come indicato in precedenza, creare un thread di lavoro per ogni processore.

Nota La specifica di un processore deve in genere essere evitata perché può interferire con la capacità dell'utilità di pianificazione di pianificare in modo efficace i thread tra processori. Passare invece il valore XAUDIO2_DEFAULT_PROCESSOR (vedere di seguito).

Il valore speciale XAUDIO2_DEFAULT_PROCESSOR fa sì che XAudio2 usi il processore predefinito.

Valore restituito

Restituisce S_OK in caso di esito positivo, in caso contrario, un codice di errore. Per le descrizioni dei codici di errore specifici di XAudio2, vedere Codici di errore XAudio2 .

Commenti

Le versioni di DirectX SDK di XAUDIO2 supportavano un flag XAUDIO2_DEBUG_ENGINE per selezionare tra la versione rilasciata e quella selezionata. Questo flag non è supportato o definito nella versione Windows 8 di XAUDIO2.

Nota Nessuna versione di DirectX SDK contiene la libreria di importazione xaudio2.lib. Le versioni di DirectX SDK usano COM per creare un nuovo oggetto XAudio2 .

Requisiti della piattaforma

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

Windows Phone 8.1: questa API è supportata.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	xaudio2.h
Libreria	Xaudio2.lib
DLL	Windows.Media.Audio.dll

Vedi anche

Procedura: Creare un grafico di elaborazione audio di base

Funzioni XAudio2

Condividi tramite