KSPROPERTY_SYSAUDIO_DEVICE_COUNT
A propriedade KSPROPERTY_SYSAUDIO_DEVICE_COUNT recupera uma contagem que especifica o número de dispositivos de áudio virtual que um programa de aplicativo DirectSound precisa escolher.
Tabela de Resumo de Uso
Obter | Definir | Destino | Tipo de descritor de propriedade | Tipo de valor da propriedade |
---|---|---|---|---|
Sim |
Não |
Filtrar |
ULONG |
O valor da propriedade (dados de operação) é uma variável ULONG na qual SysAudio grava uma contagem especificando o número de dispositivos de áudio virtual a serem escolhidos. Se o SysAudio enumerar n dispositivos de áudio virtual, esses dispositivos serão identificados por IDs de dispositivo 0 a n-1.
Valor retornado
Uma solicitação de propriedade KSPROPERTY_SYSAUDIO_DEVICE_COUNT 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 SysAudio enumera um dispositivo de áudio virtual exclusivo para cada dispositivo de hardware habilitado no sistema que executa a renderização de ondas. Em cada instância, o dispositivo de áudio virtual é composto pelo dispositivo de hardware, pelo driver do sistema KMixer e por outros componentes de áudio. Um programa de aplicativo DirectSound seleciona um dispositivo de hardware específico selecionando o dispositivo de áudio virtual que incorpora o dispositivo de hardware.
Por exemplo, se três placas de áudio estiverem conectadas ao barramento do sistema e cada uma contiver um dispositivo de renderização de onda com um driver de miniporte WaveCyclic ou WavePci, o SysAudio enumera três dispositivos de áudio virtual com as IDs de dispositivo 0, 1 e 2.
O SysAudio mantém sua lista de dispositivos de áudio virtual no registro do sistema na categoria KSCATEGORY_AUDIO_DEVICE. Essa categoria é reservada exclusivamente para uso pelo SysAudio. O DirectSound não acessa diretamente informações sobre os dispositivos de áudio virtual do registro do sistema. Em vez disso, ele consulta o SysAudio para obter as propriedades dos dispositivos de áudio virtual.
Requisitos
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |