estrutura SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR2 (sidebandaudio.h)

Artigo
07/10/2023

A segunda versão do struct SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR. Essa versão permite que o driver do controlador forneça propriedades de dispositivo personalizadas para adicionar à interface do dispositivo de áudio.

Ele descreve as características de um ponto de extremidade de áudio sideband. O driver de áudio deve consultar essas informações para criar o filtro KS que representa esse ponto de extremidade.

Sintaxe

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;

Membros

CbSize

Tamanho do Descritor, incluindo armazenamento para UNICODE_STRING e quaisquer dados adicionais.

ContainerId

ID do contêiner Pnp para dispositivo conectado. Consulte ID do contêiner do ponto de extremidade de áudio.

Category

KSPIN_DESCRIPTOR. Categoria para indicar o fator forma. Especifica um ponteiro para um GUID de categoria de pino KS. O GUID da categoria de pino KS identifica a categoria geral de funcionalidade que o pino fornece. Exemplos de GUIDs de categoria de pino KS são KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES e KSNODETYPE_MICROPHONE, que são definidos em Ksmedia.h. Consulte Propriedade Categoria de Pino.

Direction

Especifica KSPIN_DATAFLOW_IN ou KSPIN_DATAFLOW_OUT. Confira KSPIN_DATAFLOW.

Capabilities

Recursos do ponto de extremidade como (mudo, volume, sidetone etc.). Consulte SIDEBANDAUDIO_ENDPOINT_CAPABILITIES.

FriendlyName

O armazenamento para nome amigável é anexado após o descritor e está incluído no cbSize. Consulte Nomes amigáveis para dispositivos de ponto de extremidade de áudio.

VolumePropertyValuesSize

Se houver suporte para o controle de volume remoto, esse membro conterá o tamanho dos dados retornados pela solicitação de IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES .

SidetoneVolumePropertyValueSize

Se houver suporte para o controle de volume remoto, esse membro conterá o tamanho dos dados retornados pela solicitação de IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES .

MutePropertyValuesSize

Se houver suporte para mudo remoto, o membro conterá o tamanho dos dados retornados por IOCTL_SBAUD_GET_MUTEPROPERTYVALUES.

FilterInterfacePropertyCount

O número de propriedades do dispositivo que devem ser adicionadas à interface de fábrica de filtro de áudio.

FilterInterfaceProperties

Uma estrutura DEVPROPERTY que define propriedades de dispositivo personalizadas que são adicionadas à interface do dispositivo de áudio.

Requisitos

Requisito	Valor
Cabeçalho	sidebandaudio.h

Confira também

sidebandaudio.h

SIDEBANDAUDIO_ENDPOINT_CAPABILITIES

IOCTL_SBAUD_GET_VOLUMEPROPERTYVALUES

IOCTL_SBAUD_GET_SIDETONE_VOLUMEPROPERTYVALUES

Share via