KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME
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.
Requisitos
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |
Confira também
KSPROPERTY_SYSAUDIO_DEVICE_COUNT