ACX_VOLUME_CALLBACKS structure (acxelements.h)

Artikel
02/22/2024

The ACX_VOLUME_CALLBACKS structure identifies the driver callbacks for ACX volume operations.

Syntax

typedef struct _ACX_VOLUME_CALLBACKS {
  ULONG                              Size;
  PFN_ACX_VOLUME_ASSIGN_LEVEL        EvtAcxVolumeAssignLevel;
  PFN_ACX_RAMPED_VOLUME_ASSIGN_LEVEL EvtAcxRampedVolumeAssignLevel;
  PFN_ACX_VOLUME_RETRIEVE_LEVEL      EvtAcxVolumeRetrieveLevel;
  PFN_ACX_OBJECT_PROCESS_REQUEST     EvtAcxVolumeProcessRequest;
} ACX_VOLUME_CALLBACKS, *PACX_VOLUME_CALLBACKS;

Members

Size

The length, in bytes, of this structure.

EvtAcxVolumeAssignLevel

The EVT_ACX_VOLUME_ASSIGN_LEVEL callback.

EvtAcxRampedVolumeAssignLevel

The EVT_ACX_RAMPED_VOLUME_ASSIGN_LEVEL callback.

EvtAcxVolumeRetrieveLevel

The EVT_ACX_VOLUME_RETRIEVE_LEVEL callback.

EvtAcxVolumeProcessRequest

The EVT_ACX_OBJECT_PROCESS_REQUEST callback.

Remarks

Example

Example usage is shown below.

    ACX_VOLUME_CALLBACKS            volumeCallbacks;
    ACX_VOLUME_CONFIG               volumeCfg;

    ACX_VOLUME_CALLBACKS_INIT(&volumeCallbacks);
    volumeCallbacks.EvtAcxVolumeAssignLevel = CodecC_EvtVolumeAssignLevelCallback;
    volumeCallbacks.EvtAcxVolumeRetrieveLevel = CodecC_EvtVolumeRetrieveLevelCallback;

    ACX_VOLUME_CONFIG_INIT(&volumeCfg);
    volumeCfg.ChannelsCount = MAX_CHANNELS;
    volumeCfg.Minimum = VOLUME_LEVEL_MINIMUM;
    volumeCfg.Maximum = VOLUME_LEVEL_MAXIMUM;
    volumeCfg.SteppingDelta = VOLUME_STEPPING;
    volumeCfg.Callbacks = &volumeCallbacks;

ACX requirements

Minimum ACX version: 1.0

For more information about ACX versions, see ACX version overview.

Requirements

Requirement	Value
Header	acxelements.h

Delen via