estrutura SYSAUDIO_INSTANCE_INFO (ksmedia.h)
A estrutura SYSAUDIO_INSTANCE_INFO especifica qual dispositivo de áudio virtual será aberto e inclui sinalizadores para configurar esse dispositivo.
Sintaxe
typedef struct {
KSPROPERTY Property;
ULONG Flags;
ULONG DeviceNumber;
} SYSAUDIO_INSTANCE_INFO, *PSYSAUDIO_INSTANCE_INFO;
Membros
Property
Especifica a propriedade. Esse parâmetro é uma estrutura do tipo KSPROPERTY.
Flags
Sinalizadores que especificam como configurar o dispositivo de áudio virtual. Atualmente, o único bit de sinalizador definido para esse parâmetro é SYSAUDIO_FLAGS_DONT_COMBINE_PINS. Se definido, esse bit de sinalizador instrui SysAudio a não combinar pinos de renderização. Para obter mais informações, consulte a seção Comentários a seguir.
DeviceNumber
Especifica a ID do dispositivo. Esse membro identifica o dispositivo de áudio virtual que deve ser aberto pela solicitação de propriedade. Se o SysAudio enumerar N dispositivos de áudio virtual (consulte KSPROPERTY_SYSAUDIO_DEVICE_COUNT), as IDs de dispositivo válidas variam de 0 a N-1.
Observações
Essa estrutura é usada pela propriedade KSPROPERTY_SYSAUDIO_INSTANCE_INFO.
Por padrão, um dispositivo de áudio virtual combina seus pinos de renderização de onda. O sinalizador SYSAUDIO_FLAGS_DONT_COMBINE_PINS substitui esse padrão.
Quando os pinos são combinados, o dispositivo de áudio virtual expõe uma única fábrica de pinos que combina pinos de renderização aceleradas por hardware no dispositivo de áudio com pinos de mixer emulados por software no do driver do sistema KMixer. Se os pinos não forem combinados, os pinos acelerados por hardware e os pinos emulados por software serão expostos por meio de fábricas de pinos separadas. Para relatar corretamente o número de pinos acelerados por hardware para programas de aplicativo, o DirectSound exige que os pinos não sejam combinados.
Essa propriedade é semelhante a KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE, com exceção de que inclui sinalizadores que especificam como configurar o dispositivo de áudio virtual.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | ksmedia.h (inclua Ksmedia.h) |
Consulte também
KSPROPERTY_SYSAUDIO_DEVICE_COUNT