ISpatialAudioObjectForHrtf::SetDirectivity method
Sets the spatial audio directivity model for the ISpatialAudioObjectForHrtf.
Syntax
HRESULT SetDirectivity( SpatialAudioHrtfDirectivityUnion directivity );
Parameters
- directivity
-
The spatial audio directivity model. This value can be one of the following structures:
Return value
If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.
| Return code | Description |
|---|---|
|
ISpatialAudioObjectRenderStreamForHrtf::BeginUpdatingAudioObjects was not called before the call to SetDirectivity. |
|
SetEndOfStream was called either explicitly or implicitly in a previous audio processing pass. SetEndOfStream is called implicitly by the system if GetBuffer is not called within an audio processing pass (between calls to ISpatialAudioObjectRenderStreamForHrtf::BeginUpdatingAudioObjects and ISpatialAudioObjectRenderStreamForHrtf::EndUpdatingAudioObjects). |
Remarks
The SpatialAudioHrtfDirectivity structure represents an omnidirectional model that can be linearly interpolated with a cardioid or cone model.
If SetDirectivity is not called, the default type of SpatialAudioHrtfDirectivity_OmniDirectional is used with no interpolation.
Requirements
|
Header |
|
|---|
See also