KSPROPERTY_SYSAUDIO_DEVICE_COUNT
La propriété KSPROPERTY_SYSAUDIO_DEVICE_COUNT récupère un nombre spécifiant le nombre de périphériques audio virtuels parmi lesquels un programme d’application DirectSound doit choisir.
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 |
La valeur de propriété (données d’opération) est une variable ULONG dans laquelle SysAudio écrit un nombre spécifiant le nombre de périphériques audio virtuels parmi lesquels choisir. Si SysAudio énumère n périphériques audio virtuels, ces appareils sont identifiés par les ID d’appareil 0 à n-1.
Valeur de retour
Une demande de propriété KSPROPERTY_SYSAUDIO_DEVICE_COUNT retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée correctement. Sinon, la requête retourne une erreur appropriée status code.
Notes
SysAudio énumère un périphérique audio virtuel unique pour chaque périphérique matériel activé dans le système qui effectue le rendu des ondes. Dans chaque instance, le périphérique audio virtuel est composé du périphérique matériel, du pilote système KMixer et d’autres composants audio. Un programme d’application DirectSound sélectionne un périphérique matériel particulier en sélectionnant l’appareil audio virtuel qui intègre l’appareil matériel.
Par exemple, si trois cartes audio sont connectées au bus système et que chacune contient un appareil de rendu d’ondes avec un pilote de miniport WaveCyclique ou WavePci, SysAudio énumère trois périphériques audio virtuels avec les ID d’appareil 0, 1 et 2.
SysAudio conserve sa liste de périphériques audio virtuels dans le registre système sous la catégorie KSCATEGORY_AUDIO_DEVICE. Cette catégorie est réservée exclusivement à SysAudio. DirectSound n’accède pas directement aux informations sur les périphériques audio virtuels à partir du registre système. Au lieu de cela, il interroge SysAudio pour connaître les propriétés des périphériques audio virtuels.
Spécifications
En-tête |
Ksmedia.h (inclure Ksmedia.h) |