structure SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR (sidebandaudio.h)

Article
02/26/2024

La structure SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR décrit les caractéristiques d’un point de terminaison audio à 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_DESCRIPTOR {
  ULONG                               CbSize;
  GUID                                ContainerId;
  GUID                                Category;
  KSPIN_DATAFLOW                      Direction;
  SIDEBANDAUDIO_ENDPOINT_CAPABILITIES Capabilities;
  UNICODE_STRING                      FriendlyName;
  ULONG                               VolumePropertyValuesSize;
  ULONG                               SidetoneVolumePropertyValueSize;
  ULONG                               MutePropertyValuesSize;
} SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR, *PSIDEBANDAUDIO_ENDPOINT_DESCRIPTOR;

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 catégorie de broche KS identifie la catégorie générale de fonctionnalités que la broche fournit. Des exemples de GUID de catégorie de brocheS KS sont KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES et KSNODETYPE_MICROPHONE, qui sont tous définis dans Ksmedia.h. Consultez Pin Category, propriété.

Direction

Spécifie KSPIN_DATAFLOW_IN ou KSPIN_DATAFLOW_OUT. Voir KSPIN_DATAFLOW.

Capabilities

Fonctionnalités du point de terminaison telles que (mute, volume, sidetone, etc.). Voir SIDEBANDAUDIO_ENDPOINT_CAPABILITIES.

FriendlyName

Le stockage pour le 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 à distance est pris en charge, ce membre contient la taille des données retournées par la demande IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES .

SidetoneVolumePropertyValueSize

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

MutePropertyValuesSize

Si le mute à distance est pris en charge, le membre contient la taille des données retournées par IOCTL_SBAUD_GET_MUTEPROPERTYVALUES.