estrutura KSDS3D_HRTF_INIT_MSG (ksmedia.h)
A estrutura KSDS3D_HRTF_INIT_MSG especifica as configurações de parâmetro a serem usadas para inicializar a HRTF (função de transferência relativa à cabeça).
Sintaxe
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;
Membros
Size
Especifica o tamanho em bytes da estrutura.
Quality
Especifica o nível de qualidade do filtro HRTF. Defina esse parâmetro como um dos seguintes valores de enumeração KSDS3D_HRTF_FILTER_QUALITY:
- LIGHT_FILTER seleciona um algoritmo eficiente que produz um efeito de boa qualidade.
- FULL_FILTER seleciona um algoritmo que produz um efeito de alta qualidade, mas requer mais tempo de processamento.
SampleRate
Especifica a taxa de amostragem, em amostras por segundo (hertz), na qual cada canal deve ser reproduzido. Por exemplo, um valor de 22.050 especifica uma taxa de amostragem de 22,05 kHz.
MaxFilterSize
Especifica o tamanho máximo do filtro em bytes. Se o filtro estiver em forma direta, o tamanho máximo será a ordem do filtro (numerador e denominador têm ordem igual). Se o filtro estiver em cascata, o tamanho máximo será o número máximo de coeficientes biquadráticos.
FilterTransientMuteLength
Especifica quanto tempo atrasar o desbotamento cruzado para o novo filtro para evitar a introdução do sinal transitório inicial do novo filtro no sinal de saída. O atraso é especificado como um número de amostras iniciais produzidas pelo novo filtro. Durante esse tempo, a saída vem apenas dos filtros antigos.
FilterOverlapBufferLength
Especifica o número total de amostras sobre as quais ativar mudo e esmaecimento cruzado nas saídas do filtro.
OutputOverlapBufferLength
Especifica o número de amostras sobre as quais os canais de saída serão esmaecedos cruzados após uma transição pelo ângulo zero de azimuth. Esse membro é usado quando o desbotamento cruzado dos canais de saída é habilitado pelo membro CrossFadeOutput do KSDS3D_HRTF_PARAMS_MSG.
Reserved
Reservado. Defina como zero.
Comentários
Essa estrutura é usada pela propriedade KSPROPERTY_HRTF3D_INITIALIZE .
Os valores de Qualidade FULL_FILTER e LIGHT_FILTER correspondem às configurações de GUID_DS3DALG_HRTF_FULL e GUID_DS3DALG_HRTF_LIGHT descritas na documentação do SDK do Microsoft Windows.
Para obter mais informações, consulte KSPROPSETID_Hrtf3d.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ksmedia.h (inclua Ksmedia.h) |