KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

Article
06/14/2023

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).