KSDS3D_HRTF_INIT_MSG 구조체(ksmedia.h)

  • 아티클

KSDS3D_HRTF_INIT_MSG 구조는 HRTF(헤드 상대 전송 함수)를 초기화하는 데 사용할 매개 변수 설정을 지정합니다.

구문

typedef struct {
  ULONG                      Size;
  KSDS3D_HRTF_FILTER_QUALITY Quality;
  FLOAT                      SampleRate;
  ULONG                      MaxFilterSize;
  ULONG                      FilterTransientMuteLength;
  ULONG                      FilterOverlapBufferLength;
  ULONG                      OutputOverlapBufferLength;
  ULONG                      Reserved;
} KSDS3D_HRTF_INIT_MSG, *PKSDS3D_HRTF_INIT_MSG;

멤버

Size

구조체의 크기(바이트)를 지정합니다.

Quality

HRTF 필터 품질 수준을 지정합니다. 이 매개 변수를 다음 KSDS3D_HRTF_FILTER_QUALITY 열거형 값 중 하나로 설정합니다.

  • LIGHT_FILTER 좋은 품질 효과를 생성하는 효율적인 알고리즘을 선택합니다.
  • FULL_FILTER 고품질 효과를 생성하지만 처리 시간이 더 필요한 알고리즘을 선택합니다.

SampleRate

각 채널을 재생해야 하는 샘플 속도를 초당 샘플(hertz)으로 지정합니다. 예를 들어 값 22,050은 22.05kHz의 샘플 속도를 지정합니다.

MaxFilterSize

최대 필터 크기(바이트)를 지정합니다. 필터가 직접 형식인 경우 최대 크기는 필터의 순서입니다(숫자 및 분모의 순서는 같음). 필터가 계단식 형식인 경우 최대 크기는 양수 계수의 최대 수입니다.

FilterTransientMuteLength

새 필터의 초기 일시적인 신호가 출력 신호에 도입되지 않도록 새 필터에 대한 교차 페이딩을 지연할 시간을 지정합니다. 지연은 새 필터에서 생성된 여러 초기 샘플로 지정됩니다. 이 시간 동안 출력은 이전 필터에서만 제공됩니다.

FilterOverlapBufferLength

필터 출력을 음소거하고 교차 페이드할 샘플의 총 수를 지정합니다.

OutputOverlapBufferLength

지근 각도 0에서 전환한 후 출력 채널을 교차 페이드할 샘플 수를 지정합니다. 이 멤버는 출력 채널의 교차 페이딩이 KSDS3D_HRTF_PARAMS_MSGCrossFadeOutput 멤버에 의해 활성화될 때 사용됩니다.

Reserved

예약되어 있습니다. 0으로 설정됩니다.

설명

이 구조체는 KSPROPERTY_HRTF3D_INITIALIZE 속성에서 사용됩니다.

FULL_FILTER 및 LIGHT_FILTER 품질 값은 Microsoft Windows SDK 설명서에 설명된 GUID_DS3DALG_HRTF_FULL 및 GUID_DS3DALG_HRTF_LIGHT 설정에 해당합니다.

자세한 내용은 KSPROPSETID_Hrtf3d 참조하세요.

요구 사항

요구 사항 값
헤더 ksmedia.h(Ksmedia.h 포함)

추가 정보

KSDS3D_HRTF_PARAMS_MSG

KSPROPERTY_HRTF3D_INITIALIZE

KSPROPSETID_Hrtf3d