structure SYSAUDIO_INSTANCE_INFO (ksmedia.h)

  • Article

La structure SYSAUDIO_INSTANCE_INFO spécifie le périphérique 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 le périphérique audio virtuel. Actuellement, le seul bit d’indicateur défini pour ce paramètre est SYSAUDIO_FLAGS_DONT_COMBINE_PINS. S’il est défini, ce bit d’indicateur indique à SysAudio de ne pas combiner les broches de rendu. Pour plus d'informations, consultez la section Notes qui suit.

DeviceNumber

Spécifie l’ID de l’appareil. Ce membre identifie le périphérique audio virtuel qui doit être ouvert 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 vont de 0 à 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 les broches sont combinées, le périphérique audio virtuel expose une fabrique de broches unique qui combine des broches de rendu accélérées matériellement sur le périphérique audio avec des broches mixer émulées par logiciel sur le pilote système KMixer. Si les broches ne sont pas combinées, les broches accélérées matériellement 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 du fait qu’elle inclut des indicateurs spécifiant comment configurer le périphérique audio virtuel.

Configuration requise

Condition requise Valeur
En-tête ksmedia.h (incluez Ksmedia.h)

Voir aussi

KSPROPERTY

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

KSPROPERTY_SYSAUDIO_INSTANCE_INFO