Partager via


KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME

La propriété KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME récupère une chaîne Unicode contenant le nom convivial du périphérique audio virtuel.

Tableau récapitulatif de l’utilisation

Obtenir Définissez Cible Type de descripteur de propriété Type de valeur de propriété

Oui

Non

Filtrer

KSPROPERTY+ULONG

LPWSTR

Le descripteur de propriété (instance données) se compose d’une structure KSPROPERTY suivie d’une variable ULONG contenant un ID d’appareil qui identifie un périphérique audio virtuel. Si SysAudio énumère n périphériques audio virtuels (voir KSPROPERTY_SYSAUDIO_DEVICE_COUNT), les ID d’appareil valides sont compris entre 0 et n-1. En outre, une valeur d’ID d’appareil de -1 peut être utilisée pour indiquer l’appareil actuel, qui est le dernier périphérique audio virtuel ouvert par un KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE ou KSPROPERTY_SYSAUDIO_INSTANCE_INFOdemande set-property.

La valeur de propriété (données d’opération) est un pointeur vers une chaîne de caractères Unicode terminée par un caractère Null qui contient le nom convivial de l’appareil.

Valeur de retour

Une demande de propriété KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la requête retourne une erreur appropriée status code.

Spécifications

En-tête

Ksmedia.h (inclure Ksmedia.h)

Voir aussi

KSPROPERTY

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

KSPROPERTY_SYSAUDIO_INSTANCE_INFO