Partager via


structure SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2 (sidebandaudio.h)

Deuxième version du struct SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR. Cette version permet au pilote du contrôleur de fournir des propriétés d’appareil personnalisées à ajouter à l’interface de l’appareil audio.

Il décrit les caractéristiques d’un point de terminaison audio de bande latérale. Le pilote audio doit interroger ces informations pour générer le filtre KS représentant ce point de terminaison.

Syntaxe

typedef struct _SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2 {
  ULONG                               CbSize;
  GUID                                ContainerId;
  GUID                                Category;
  KSPIN_DATAFLOW                      Direction;
  SIDEBANDAUDIO_ENDPOINT_CAPABILITIES Capabilities;
  UNICODE_STRING                      FriendlyName;
  ULONG                               VolumePropertyValuesSize;
  ULONG                               SidetoneVolumePropertyValueSize;
  ULONG                               MutePropertyValuesSize;
  ULONG                               FilterInterfacePropertyCount;
  DEVPROPERTY                         *FilterInterfaceProperties;
} SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2, *PSIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2;

Membres

CbSize

Taille du descripteur, y compris le stockage pour UNICODE_STRING et toutes les données supplémentaires.

ContainerId

ID de conteneur Pnp pour l’appareil connecté. Consultez 'ID de conteneur de point de terminaison audio.

Category

KSPIN_DESCRIPTOR. Catégorie pour indiquer le facteur de forme. Spécifie un pointeur vers un GUID de catégorie de broche KS. Le GUID de la catégorie de broche KS identifie la catégorie générale des fonctionnalités que fournit la broche. Les GUID de catégorie de broche KS sont KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES et KSNODETYPE_MICROPHONE, qui sont tous définis dans Ksmedia.h. Voir propriété Pin Category.

Direction

Spécifie KSPIN_DATAFLOW_IN ou KSPIN_DATAFLOW_OUT. Voir KSPIN_DATAFLOW.

Capabilities

Fonctionnalités du point de terminaison comme (muet, volume, sidetone, etc.). Voir SIDEBANDAUDIO_ENDPOINT_CAPABILITIES.

FriendlyName

Le stockage pour un nom convivial est attaché après le descripteur et est inclus dans cbSize. Consultez noms conviviaux pour les appareils de point de terminaison audio.

VolumePropertyValuesSize

Si le contrôle de volume distant est pris en charge, ce membre contient la taille des données retournées par la requête IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES.

SidetoneVolumePropertyValueSize

Si le contrôle de volume distant est pris en charge, ce membre contient la taille des données retournées par la demande de IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES.

MutePropertyValuesSize

Si le son distant est pris en charge, le membre contient la taille des données retournées par IOCTL_SBAUD_GET_MUTEPROPERTYVALUES.

FilterInterfacePropertyCount

Nombre de propriétés d’appareil qui doivent être ajoutées à l’interface de fabrique de filtre audio.

FilterInterfaceProperties

Une structure DEVPROPERTY qui définit les propriétés d’appareil personnalisées ajoutées à l’interface de l’appareil audio.

Exigences

Exigence Valeur
d’en-tête sidebandaudio.h

Voir aussi

sidebandaudio.h

SIDEBANDAUDIO_ENDPOINT_CAPABILITIES

IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES

IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES