Share via

estrutura ACX_EVENT_CONFIG (acxevents.h)

  • Artigo

A estrutura ACX_EVENT_CONFIG é usada para configurar um ACXEVENT.

Sintaxe

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;

Membros

Size

O comprimento, em bytes, dessa estrutura.

Flags

OR bit a bit de ACX_PNPEVENT_CONFIG_FLAGS.

Set

Especifica o conjunto de eventos. Esse membro é um ponteiro para um GUID que identifica exclusivamente o conjunto de eventos. Consulte a lista de GUIDs do conjunto de eventos em Conjuntos de Eventos de Drivers de Áudio.

Este é um KSEVENTSETID, por exemplo, KSEVENTSETID_AudioControlChange. Para obter mais informações sobre, consulte Estrutura KSEVENTDATA (ks.h).

Id

Especifica a ID do evento. Esse membro identifica um item de evento dentro do conjunto de eventos. Se o conjunto de eventos contiver N itens, as IDs de evento válidas serão inteiros no intervalo de 0 a N-1.

Type

O tipo de valor de evento (dados de operação) é uma estrutura KSEVENTDATA que especifica o método de notificação a ser usado para esse evento.

Callbacks

A estrutura ACX_EVENT_CALLBACKS que identifica os retornos de chamada do driver para operações de evento ACX.

Comentários

Exemplo

O exemplo mostra como o ACX usa a estrutura 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;

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxevents.h

Confira também