IXACTEngine::CreateStreamingWaveBank

Creates an IXACTWaveBank instance.

[Code-driven][Content-driven]

  HRESULT 
  CreateStreamingWaveBank(
  const XACT_WAVEBANK_STREAMING_PARAMETERS *pParms,
  IXACTWaveBank **ppWaveBank
);

pParms
[in] Pointer to an XACT_WAVEBANK_STREAMING_PARAMETERS structure that describes the streaming wave bank to create.
ppWaveBank
[out] Pointer to the location of the handle for the newly created IXACTWaveBank instance.

Returns S_OK if successful. Otherwise, an error code.

Do not use a sound that is associated with a streaming wave bank unless you know that the wave bank is prepared.

To ascertain that the wave bank is prepared, do one of the following:

Create an XACTNOTIFICATIONTYPE_WAVEBANKPREPARED notification by using IXACTEngine::RegisterNotification.

–or–
Issue a query about the state of the wave bank by using IXACTWaveBank::GetState. When the XACT_WAVEBANKSTATE_PREPARED bit is set, you can use the wave bank.

Header: Declared in Xact.h.

Library: Use Xact.lib.

Additional resources