KSDS3D_HRTF_PARAMS_MSG structure (ksmedia.h)

The KSDS3D_HRTF_PARAMS_MSG structure specifies the parameter settings to apply to a head-relative transfer function (HRTF).

Syntax

typedef struct {
  ULONG Size;
  ULONG Enabled;
  BOOL  SwapChannels;
  BOOL  ZeroAzimuth;
  BOOL  CrossFadeOutput;
  ULONG FilterSize;
} KSDS3D_HRTF_PARAMS_MSG, *PKSDS3D_HRTF_PARAMS_MSG;

Members

Size

Specifies the size in bytes of the structure.

Enabled

Specifies whether to enable HRTF processing. If nonzero, HRTF is enabled. If zero, it is disabled.

SwapChannels

Specifies whether the algorithm should swap channels. If TRUE, the algorithm should swap the channels to perform a left-to-right reversal of the location of the source. If FALSE, the algorithm should not swap the channels.

ZeroAzimuth

Specifies whether the azimuth angle is zero. If TRUE, then only half of the filter coefficients are downloaded to the filter because the azimuth angle is zero. If FALSE, all the coefficients are downloaded.

CrossFadeOutput

Specifies whether to cross-fade the output channels after crossing azimuth angle zero. If TRUE, the algorithm should cross-fade the output channels. If FALSE, it should not cross-fade the channels.

FilterSize

Specifies the additional size in bytes of the filter coefficients that are appended to this structure.

Remarks

This structure is used by the KSPROPERTY_HRTF3D_PARAMS property.

For more information, see KSPROPSETID_Hrtf3d.

Requirements

Requirement	Value
Header	ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY_HRTF3D_PARAMS

KSPROPSETID_Hrtf3d