Estrutura AudioClientProperties (audioclient.h)

Artigo
02/28/2024

A estrutura AudioClientProperties é usada para definir os parâmetros que descrevem as propriedades do fluxo de áudio do cliente.

Sintaxe

typedef struct AudioClientProperties {
  UINT32                cbSize;
  BOOL                  bIsOffload;
  AUDIO_STREAM_CATEGORY eCategory;
  AUDCLNT_STREAMOPTIONS Options;
} AudioClientProperties;

Membros

cbSize

O tamanho da estrutura AudioClientProperties , em bytes.

bIsOffload

Valor booliano para indicar se o fluxo de áudio é descarregado por hardware ou não.

eCategory

Uma enumeração usada para especificar a categoria do fluxo de áudio.

Options

Um membro da enumeração AUDCLNT_STREAMOPTIONS que descreve as características do fluxo.

Com suporte em Windows 8.1 e posteriores.

Comentários

Começando com Windows 10, os fluxos de áudio descarregados por hardware devem ser controlados por eventos. Isso significa que, se você chamar IAudioClient2::SetClientProperties e definir o parâmetro bIsOffload do AudioClientProperties como TRUE, deverá especificar o sinalizador AUDCLNT_STREAMFLAGS_EVENTCALLBACK no parâmetro StreamFlags como IAudioClient::Initialize.