estrutura SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR (sidebandaudio.h)

Artigo
05/23/2024

A estrutura SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR 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_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;

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.