KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME

Artigo
06/15/2023

A propriedade KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME recupera uma cadeia de caracteres Unicode que contém o nome amigável do dispositivo de áudio virtual.

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Não	Filtrar	KSPROPERTY+ULONG	LPWSTR

O descritor de propriedade (dados de instância) consiste em uma estrutura KSPROPERTY seguida por uma variável ULONG que contém uma ID de dispositivo que identifica 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. Além disso, um valor de ID do dispositivo de -1 pode ser usado para indicar o dispositivo atual, que é o último dispositivo de áudio virtual aberto por um KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE ou KSPROPERTY_SYSAUDIO_INSTANCE_INFOsolicitação set-property.

O valor da propriedade (dados de operação) é um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome amigável do dispositivo.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.