KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE

A propriedade KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE cria uma nova fonte virtual.

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Não	Filtrar	SYSAUDIO_CREATE_VIRTUAL_SOURCE	ULONG

O descritor de propriedade (dados de instância) é uma estrutura do tipo SYSAUDIO_CREATE_VIRTUAL_SOURCE que especifica os GUIDs pin-category e pin-name para a origem virtual.

O valor da propriedade (dados de operação) é uma variável ULONG que contém o índice de origem virtual. O SysAudio gera esse índice para identificar a nova fonte virtual.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE 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

Essa propriedade é usada para criar uma fonte virtual de linha de mixer, como um controle de volume ou mudo.

Se o SysAudio já tiver criado uma fonte virtual com os mesmos GUIDs pin-category e pin-name, um KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE solicitação get-property recuperará o índice para a fonte virtual existente. Caso contrário, a solicitação gera um novo índice de origem virtual e gera esse valor.

Depois que o SysAudio atribuir um índice a uma fonte virtual, uma KSPROPERTY_SYSAUDIO_ATTACH_VIRTUAL_SOURCEsolicitação set-property poderá ser usada para anexar essa fonte virtual a uma instância de pino no dispositivo de áudio virtual.

O usuário controla os níveis de volume de várias fontes de áudio por meio do aplicativo SndVol32. Essas fontes incluem o dispositivo de saída de onda, o sintetizador MIDI, o player de CD e o conector de entrada de linha. O SndVol32 usa as funções waveOutXxx, midiOutXxx e auxXxx do Windows para controlar os níveis de volume dessas fontes. Para obter mais informações sobre funções multimídia do Windows, consulte a documentação do SDK do Microsoft Windows.

O SysAudio intercepta as alterações de volume feitas nesses dispositivos e as aplica às suas fontes virtuais. Por exemplo, se um sintetizador MIDI de software que converte um arquivo MIDI em dados de onda estiver conectado a um dos pinos de renderização de onda do dispositivo de áudio virtual, o SysAudio aplicará alterações de volume midiOutXxx ao pino (em vez de alterações de volume waveOutXxx ). Da mesma forma, se o driver do sistema Redbook, que converte áudio digital de um player de CD em dados de onda, estiver conectado a um dos pinos de renderização de onda do dispositivo de áudio virtual, o SysAudio aplicará AUXCAPS_CDAUDIO alterações de volume ao pino. Para obter mais informações sobre a estrutura AUXCAPS_CDAUDIO, consulte a documentação do SDK do Windows.

Requisitos

parâmetro

Ksmedia.h (inclua Ksmedia.h)

Confira também

SYSAUDIO_CREATE_VIRTUAL_SOURCE

KSPROPERTY_SYSAUDIO_ATTACH_VIRTUAL_SOURCE