estrutura KSAUDIO_PREFERRED_STATUS (ksmedia.h)

A estrutura KSAUDIO_PREFERRED_STATUS especifica o status de um dispositivo preferencial.

Sintaxe

typedef struct {
  BOOL                             Enable;
  KSPROPERTY_SYSAUDIO_DEFAULT_TYPE DeviceType;
  ULONG                            Flags;
  ULONG                            Reserved;
} KSAUDIO_PREFERRED_STATUS, *PKSAUDIO_PREFERRED_STATUS;

Membros

Enable

Especifica se o dispositivo de destino é o novo dispositivo preferencial. Se TRUE, o dispositivo de destino será selecionado como o novo dispositivo preferencial. Se FALSE, o dispositivo de destino era anteriormente o dispositivo preferencial, mas agora está desmarcado.

DeviceType

Especifica o tipo de dispositivo preferencial. Esse parâmetro é definido como uma das seguintes constantes:

Valor	Tipo de dispositivo
KSPROPERTY_SYSAUDIO_NORMAL_DEFAULT	Dispositivo preferencial para reprodução/gravação de onda, MIDI e topologia de mixer.
KSPROPERTY_SYSAUDIO_PLAYBACK_DEFAULT	Dispositivo de reprodução de onda preferencial.
KSPROPERTY_SYSAUDIO_RECORD_DEFAULT	Dispositivo de gravação de onda preferencial.
KSPROPERTY_SYSAUDIO_MIDI_DEFAULT	Dispositivo MIDI preferencial.
KSPROPERTY_SYSAUDIO_MIXER_DEFAULT	Dispositivo de topologia de mixer preferencial.

O driver usa esse membro para determinar quais aspectos ou aspectos do adaptador de áudio estão selecionados como preferenciais no momento. Um driver pode usar essas informações para decidir como se configurar ou decidir quais recursos do sistema solicitar.

Flags

Nenhum sinalizador está definido no momento. Defina como zero.

Reserved

Reservado para uso futuro. Defina como zero.

Comentários

Essa estrutura é usada pela propriedade KSPROPERTY_AUDIO_PREFERRED_STATUS .

Para obter informações sobre o dispositivo preferencial, consulte SetupPreferredAudioDevices.

Requisitos

Requisito	Valor
Cabeçalho	ksmedia.h (inclua Ksmedia.h)

Confira também

KSPROPERTY_AUDIO_PREFERRED_STATUS

SetupPreferredAudioDevices