Partager via


KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

La propriété KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE spécifie la instance actuelle d’un 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

Oui

Filtrer

KSPROPERTY

ULONG

La valeur de propriété (données d’opération) est de type ULONG et spécifie l’ID d’appareil d’un périphérique audio virtuel. Si SysAudio énumère n appareils audio virtuels (voir KSPROPERTY_SYSAUDIO_DEVICE_COUNT), les ID d’appareil valides sont compris entre 0 et n-1.

Valeur de retour

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

Notes

Une KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE demande set-property ouvre le périphérique audio virtuel spécifié par l’ID d’appareil contenu dans la valeur de propriété. Le dernier appareil à ouvrir est appelé l’appareil actuel.

Certaines propriétés SysAudio permettent à l’appareil actuel d’être identifié par un ID d’appareil null de -1 plutôt que par un ID d’appareil valide dans la plage de 0 à n-1, où n est le nombre d’appareils audio virtuels disponibles. Ces propriétés incluent KSPROPERTY_SYSAUDIO_DEVICE_INTERFACE_NAME et KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME.

Une demande get-property récupère l’ID de l’appareil audio virtuel actuel (dernière ouverture).

Spécifications

En-tête

Ksmedia.h (inclure Ksmedia.h)

Voir aussi

KSPROPERTY

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

KSPROPERTY_SYSAUDIO_DEVICE_INTERFACE_NAME

KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME