Partager via


structure SYSAUDIO_INSTANCE_INFO (ksmedia.h)

La structure SYSAUDIO_INSTANCE_INFO spécifie l’appareil audio virtuel à ouvrir et inclut des indicateurs pour la configuration de cet appareil.

Syntaxe

typedef struct {
  KSPROPERTY Property;
  ULONG      Flags;
  ULONG      DeviceNumber;
} SYSAUDIO_INSTANCE_INFO, *PSYSAUDIO_INSTANCE_INFO;

Membres

Property

Spécifie la propriété. Ce paramètre est une structure de type KSPROPERTY.

Flags

Indicateurs spécifiant comment configurer l’appareil audio virtuel. Actuellement, le seul bit d’indicateur défini pour ce paramètre est SYSAUDIO_FLAGS_DONT_COMBINE_PINS. Si cette valeur est définie, ce bit d’indicateur indique à SysAudio de ne pas combiner les broches de rendu. Pour plus d’informations, consultez la section Remarques suivante.

DeviceNumber

Spécifie l’ID de l’appareil. Ce membre identifie l’appareil audio virtuel à ouvrir par la demande de propriété. 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.

Remarques

Cette structure est utilisée par la propriété KSPROPERTY_SYSAUDIO_INSTANCE_INFO.

Par défaut, un périphérique audio virtuel combine ses broches de rendu d’ondes. L’indicateur SYSAUDIO_FLAGS_DONT_COMBINE_PINS remplace cette valeur par défaut.

Lorsque des broches sont combinées, le périphérique audio virtuel expose une seule fabrique de broches qui combine des broches de rendu accélérées matériellement sur l’appareil audio avec des broches de mélangeur émulées par logiciel sur le pilote système KMixer . Si les broches ne sont pas combinées, les broches à accélération matérielle et les broches émulées par logiciel sont exposées via des fabriques de broches distinctes. Pour signaler correctement le nombre de broches accélérées matériellement aux programmes d’application, DirectSound exige que les broches ne soient pas combinées.

Cette propriété est similaire à KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE, à l’exception qu’elle inclut des indicateurs spécifiant comment configurer l’appareil audio virtuel.

Exigences

Exigence Valeur
d’en-tête ksmedia.h (include Ksmedia.h)

Voir aussi

KSPROPERTY

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

KSPROPERTY_SYSAUDIO_INSTANCE_INFO