KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY

Artigo
06/15/2023

A propriedade KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY é usada em combinação com KSPROPERTY_AUDIO_CHANNEL_CONFIG para implementar a propriedade de configuração do alto-falante DirectSound para áudio 3D acelerado por hardware. Essa é uma propriedade opcional de nós DAC (KSNODETYPE_DAC) e nós 3D (KSNODETYPE_3D_EFFECTS).

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Sim	Fixar/Filtrar	KSNODEPROPERTY	LONG

O valor da propriedade (dados de operação) é do tipo LONG e especifica a geometria do alto-falante. Esse valor pode ser definido como uma das seguintes constantes, que são definidas no arquivo de cabeçalho Ksmedia.h:

KSAUDIO_STEREO_SPEAKER_GEOMETRY_HEADPHONES
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MIN
KSAUDIO_STEREO_SPEAKER_GEOMETRY_NARROW
KSAUDIO_STEREO_SPEAKER_GEOMETRY_WIDE
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MAX

Os parâmetros anteriores são equivalentes em significado (mas não iguais em valor) aos seguintes valores, que são usados pelo método IDirectSound::GetSpeakerConfig (consulte a documentação do SDK do Microsoft Windows) e são definidos no arquivo de cabeçalho Dsound.h:

DSSPEAKER_HEADPHONE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MIN
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_NARROW
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_WIDE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MAX

Valor retornado

Uma solicitação de propriedade KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.