структура ACX_EVENT_CONFIG (acxevents.h)

Статья
02/06/2025

Структура ACX_EVENT_CONFIG используется для настройки ACXEVENT.

Синтаксис

typedef struct _ACX_EVENT_CONFIG {
  ULONG                Size;
  ULONG                Flags;
  const GUID           *Set;
  ULONG                Id;
  ULONG                Type;
  PACX_EVENT_CALLBACKS Callbacks;
} ACX_EVENT_CONFIG, *PACX_EVENT_CONFIG;

Члены

Size

Длина в байтах этой структуры.

Flags

Битовое ИЛИ ACX_PNPEVENT_CONFIG_FLAGS.

Set

Указывает набор событий. Этот элемент является указателем на GUID, который однозначно идентифицирует набор событий. Список идентификаторов GUID наборов событий см. в наборов событий звуковых драйверов.

Это KSEVENTSETID, например KSEVENTSETID_AudioControlChange. Дополнительные сведения см. в структуре KSEVENTDATA (ks.h).

Id

Указывает идентификатор события. Этот элемент определяет элемент события в наборе событий. Если набор событий содержит N-элементы, допустимые идентификаторы событий являются целыми числами в диапазоне от 0 до N-1.

Type

Тип значения события (данные операции) — это структура KSEVENTDATA, указывающая метод уведомления, используемый для этого события.

Callbacks

Структура ACX_EVENT_CALLBACKS, которая определяет обратные вызовы драйвера для операций событий ACX.

Замечания

Пример

В примере показано, как ACX использует структуру ACX_EVENT_CONFIG.

    ACX_EVENT_CONFIG            eventCfg;
    ACX_EVENT_CALLBACKS         eventCallbacks;
 
    //
    // Add an audio control change event to this volume element.
    //
    ACX_EVENT_CALLBACKS_INIT(&eventCallbacks);
    eventCallbacks.EvtAcxEventEnable = &AfxVolume::EvtVolumeEventEnableCallback; 
    eventCallbacks.EvtAcxEventDisable = &AfxVolume::EvtVolumeEventDisableCallback;

    ACX_EVENT_CONFIG_INIT(&eventCfg);
    eventCfg.Set = &KSEVENTSETID_AudioControlChange;
    eventCfg.Id  = KSEVENT_CONTROL_CHANGE;
    eventCfg.Callbacks = &eventCallbacks;

Требования к ACX

минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в обзоре версий ACX.

Требования

Требование	Ценность
заголовка	acxevents.h

См. также

заголовка acxevents.h

Поделиться через