KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE
La propriété KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE crée une source virtuelle.
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 |
ULONG |
Le descripteur de propriété (instance données) est une structure de type SYSAUDIO_CREATE_VIRTUAL_SOURCE qui spécifie les GUID de catégorie de broche et de nom d’épingle pour la source virtuelle.
La valeur de propriété (données d’opération) est une variable ULONG contenant l’index source virtuel. SysAudio génère cet index pour identifier la nouvelle source virtuelle.
Valeur de retour
Une demande de propriété KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE 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
Cette propriété est utilisée pour créer une source virtuelle de ligne de mixage, telle qu’un contrôle de volume ou de désactivation.
Si SysAudio a déjà créé une source virtuelle avec les mêmes GUID pin-category et pin-name, une requête get-property KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE récupère l’index de la source virtuelle existante. Sinon, la requête génère un nouvel index de source virtuelle et génère cette valeur.
Une fois que SysAudio a affecté un index à une source virtuelle, une KSPROPERTY_SYSAUDIO_ATTACH_VIRTUAL_SOURCEdemande set-property peut être utilisée pour attacher cette source virtuelle à une instance pin sur l’appareil audio virtuel.
L’utilisateur contrôle les niveaux de volume de différentes sources audio via l’application SndVol32. Ces sources incluent le périphérique de sortie d’ondes, le synthétiseur MIDI, le lecteur CD et la prise jack line-in. SndVol32 utilise les fonctions windows multimedia waveOutXxx, midiOutXxx et auxXxx pour contrôler les niveaux de volume pour ces sources. Pour plus d’informations sur les fonctions multimédias Windows, consultez la documentation Microsoft Windows SDK.
SysAudio intercepte les modifications de volume apportées à ces appareils et les applique à ses sources virtuelles. Par exemple, si un synthétiseur MIDI logiciel qui convertit un fichier MIDI en données d’onde est connecté à l’une des broches de rendu d’onde de l’appareil audio virtuel, SysAudio applique les modifications de volume midiOutXxx à la broche (au lieu des modifications de volume waveOutXxx ). De même, si le pilote système Redbook, qui convertit l’audio numérique d’un lecteur CD en données d’onde, est connecté à l’une des broches de rendu d’ondes de l’appareil audio virtuel, SysAudio applique AUXCAPS_CDAUDIO modifications de volume à la broche. Pour plus d’informations sur la structure AUXCAPS_CDAUDIO, consultez la documentation du KIT de développement logiciel (SDK) Windows.
Spécifications
En-tête |
Ksmedia.h (inclure Ksmedia.h) |