Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

AudioClientProperties structure (audioclient.h)

The AudioClientProperties structure is used to set the parameters that describe the properties of the client's audio stream.

Syntax

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

Members

cbSize

The size of the AudioClientProperties structure, in bytes.

bIsOffload

Boolean value to indicate whether or not the audio stream is hardware-offloaded.

eCategory

An enumeration that is used to specify the category of the audio stream.

Options

A member of the AUDCLNT_STREAMOPTIONS enumeration describing the characteristics of the stream.

Supported in Windows 8.1 and later.

Remarks

Starting with Windows 10, hardware-offloaded audio streams must be event driven. This means that if you call IAudioClient2::SetClientProperties and set the bIsOffload parameter of the AudioClientProperties to TRUE, you must specify the AUDCLNT_STREAMFLAGS_EVENTCALLBACK flag in the StreamFlags parameter to IAudioClient::Initialize.

Requirements

Requirement Value
Minimum supported client Windows Build 22000
Header audioclient.h

See also

AUDCLNT_STREAMOPTIONS

AUDIO_STREAM_CATEGORY

Core Audio Structures

IAudioClient2::SetClientProperties


Feedback

Was this page helpful?

Additional resources