KSDS3D_HRTF_INIT_MSG estrutura (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 bom efeito de qualidade.
- FULL_FILTER seleciona um algoritmo que produz um efeito de alta qualidade, mas requer mais tempo de processamento.
SampleRate
Especifica a taxa de exemplo, em exemplos por segundo (hertz), em que cada canal deve ser reproduzido. Por exemplo, um valor de 22.050 especifica uma taxa de exemplo 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 forma em cascata, o tamanho máximo será o número máximo de coeficientes biquadratic.
FilterTransientMuteLength
Especifica quanto tempo atrasar o desbotamento cruzado para o novo filtro, a fim de evitar a introdução do sinal transitório inicial do novo filtro no sinal de saída. O atraso é especificado como uma série de amostras iniciais produzidas pelo novo filtro. Durante esse tempo, a saída vem somente dos filtros antigos.
FilterOverlapBufferLength
Especifica o número total de amostras sobre as quais ativar mudo e esmaecer e esmaecer as saídas do filtro.
OutputOverlapBufferLength
Especifica o número de amostras sobre as quais os canais de saída serão cruzados após uma transição no ângulo zero do azimuth. Esse membro é usado quando o desbotamento cruzado dos canais de saída é habilitado pelo membro CrossFadeOutput de KSDS3D_HRTF_PARAMS_MSG.
Reserved
Reservado. Definido como zero.
Observações
Essa estrutura é usada pela propriedade KSPROPERTY_HRTF3D_INITIALIZE.
Os valores de 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) |