estructura SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2 (sidebandaudio.h)

Artículo
04/30/2024

Segunda versión de la estructura SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR. Esta versión permite al controlador proporcionar propiedades de dispositivo personalizadas que se agreguen a la interfaz del dispositivo de audio.

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_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;

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.

FilterInterfacePropertyCount

Número de propiedades de dispositivo que se agregarán a la interfaz del generador de filtros de audio.

FilterInterfaceProperties

Estructura DEVPROPERTY que define las propiedades de dispositivo personalizadas que se agregan a la interfaz del dispositivo de audio.

Requisitos

Requisito	Valor
Header	sidebandaudio.h

Consulte también

sidebandaudio.h

SIDEBANDAUDIO_ENDPOINT_CAPABILITIES

IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES

IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES

Share via