Bewerken

Delen via


KSPROPSETID_AudioEngine

The KSPROPSETID_AudioEngine property set contains KS properties that the audio driver can use to provide more information about the hardware audio engine node.

KSPROPSETID_AudioEngine is available with Windows 8 and later versions of the Windows operating system.

When a hardware solution supports audio offloading, the audio driver for the hardware must expose its capabilities in a specific manner so that the Windows 8 user-mode audio stack can discover these capabilities and take advantage of them.

To support the audio offloading architecture provided with Windows 8, the hardware solution must implement a hardware audio engine. The audio driver for this hardware must then expose the hardware audio engine as an audio engine kernel streaming (KS) node that is contained within a KS filter. The node type that has been newly defined for this purpose is KSNODETYPE_AUDIO_ENGINE. The KSPROPERTY_AUDIOENGINE enumeration is used to represent the new KS properties.

The Ksmedia.h header file defines the KSPROPSETID_AudioEngine property set as follows:

#define STATIC_KSPROPSETID_AudioEngine\
    0x3A2F82DCL, 0x886F, 0x4BAA, 0x9E, 0xB4, 0x8, 0x2B, 0x90, 0x25, 0xC5, 0x36
DEFINE_GUIDSTRUCT("3A2F82DC-886F-4BAA-9EB4-082B9025C536", KSPROPSETID_AudioEngine);
#define KSPROPSETID_AudioEngine DEFINE_GUIDNAMED(KSPROPSETID_AudioEngine)

The KSPROPSETID_AudioEngine property set contains the following KS properties.

KSPROPERTY_AUDIOENGINE_BUFFER_SIZE_RANGE

KSPROPERTY_AUDIOENGINE_DESCRIPTOR

KSPROPERTY_AUDIOENGINE_DEVICEFORMAT

KSPROPERTY_AUDIOENGINE_GFXENABLE

KSPROPERTY_AUDIOENGINE_LFXENABLE

KSPROPERTY_AUDIOENGINE_LOOPBACK_PROTECTION

KSPROPERTY_AUDIOENGINE_MIXFORMAT

KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS

KSPROPERTY_AUDIOENGINE_VOLUMELEVEL

These property names are defined in the KSPROPERTY_AUDIOENGINE enum.