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 VERDADEIRO, 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 ondas, MIDI e topologia do 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 qual aspecto ou aspecto do adaptador de áudio está selecionado como preferencial 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. Definido como zero.
Reserved
Reservado para uso futuro. Definido como zero.
Observações
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) |