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 |
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) |