Compartilhar via


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

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

KSPROPERTY_SYSAUDIO_INSTANCE_INFO