estructura SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR (sidebandaudio.h)

Artículo
02/29/2024

La estructura SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR describe las características de un punto de conexión de audio sideband. El controlador de audio debe consultar esta información para compilar el filtro KS que representa este punto de conexión.

Sintaxis

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;

Miembros

CbSize

Tamaño del descriptor, incluido el almacenamiento para UNICODE_STRING y cualquier dato adicional.

ContainerId

Id. de contenedor de Pnp para el dispositivo conectado. Consulte Identificador de contenedor de punto de conexión de audio.

Category

KSPIN_DESCRIPTOR. Categoría para indicar el factor de forma. Especifica un puntero a un GUID de categoría de patillas KS. El GUID de categoría de patillas KS identifica la categoría general de funcionalidad que proporciona el pin. Algunos ejemplos de GUID de categoría de pin KS son KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES y KSNODETYPE_MICROPHONE, que se definen en Ksmedia.h. Vea Pin Category (propiedad).

Direction

Especifica KSPIN_DATAFLOW_IN o KSPIN_DATAFLOW_OUT. Consulte KSPIN_DATAFLOW.

Capabilities

Funcionalidades del punto de conexión como (silenciar, volumen, tono lateral, etc.). Consulte SIDEBANDAUDIO_ENDPOINT_CAPABILITIES.

FriendlyName

El almacenamiento para el nombre descriptivo se adjunta después del descriptor y se incluye en cbSize. Consulte Nombres descriptivos para dispositivos de punto de conexión de audio.

VolumePropertyValuesSize

Si se admite el control de volumen remoto, este miembro contiene el tamaño de los datos devueltos por la solicitud de IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES .

SidetoneVolumePropertyValueSize

Si se admite el control de volumen remoto, este miembro contiene el tamaño de los datos devueltos por la solicitud de IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES .

MutePropertyValuesSize

Si se admite la exclusión remota, el miembro contiene el tamaño de los datos devueltos por IOCTL_SBAUD_GET_MUTEPROPERTYVALUES.