KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

Artigo
06/15/2023

A propriedade KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE especifica a instância atual de um dispositivo de áudio virtual.

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Sim	Filtrar	KSPROPERTY	ULONG

O valor da propriedade (dados de operação) é do tipo ULONG e especifica a ID do dispositivo de um dispositivo de áudio virtual. 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.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE 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

Um KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE solicitação set-property abre o dispositivo de áudio virtual especificado pela ID do dispositivo contida no valor da propriedade. O último dispositivo a ser aberto é conhecido como o dispositivo atual.

Algumas propriedades do SysAudio permitem que o dispositivo atual seja identificado por uma ID de dispositivo nula de -1 em vez de por uma ID de dispositivo válida no intervalo de 0 a n-1, em que n é o número de dispositivos de áudio virtual disponíveis. Essas propriedades incluem KSPROPERTY_SYSAUDIO_DEVICE_INTERFACE_NAME e KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME.

Uma solicitação get-property recupera a ID do dispositivo de áudio virtual atual (aberto pela última vez).