KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY
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 |
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.
Comentários
O DirectSound trata KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY como uma propriedade de filtro em um nó DAC e como uma propriedade de pino em um nó 3D.
Para obter informações adicionais, consulte Configurações de Speaker-Configuration do DirectSound.
Requisitos
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |