estrutura PCEVENT_ITEM (portcls.h)

A estrutura PCEVENT_ITEM é usada para descrever um evento com suporte por um filtro, pino ou nó específico.

Sintaxe

typedef struct {
  const GUID         *Set;
  ULONG              Id;
  ULONG              Flags;
  PCPFNEVENT_HANDLER Handler;
} PCEVENT_ITEM, *PPCEVENT_ITEM;

Membros

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 definidos por eventos em Conjuntos de Eventos de Drivers de Áudio.

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.

Flags

Especifica o tipo de evento. Esse membro é definido como um dos seguintes valores:

PCEVENT_ITEM_FLAG_ENABLE

Indica que a notificação de evento deve ser habilitada para esse tipo de evento. O driver deve continuar a notificação de eventos até que o cliente a desabilite explicitamente.

PCEVENT_ITEM_FLAG_ONESHOT

Indica que a notificação de evento deve ser habilitada apenas para a próxima ocorrência desse evento. O cliente não desabilita (e não deve) o evento depois que ele ocorreu.

PCEVENT_ITEM_FLAG_BASICSUPPORT

Se o cliente especificar esse sinalizador, o driver retornará STATUS_SUCCESS se ele der suporte ao evento e a um código de erro se não o fizer.

Handler

Ponteiro para a rotina do manipulador de eventos do driver de miniport. Esse membro é um ponteiro de função do tipo PCPFNEVENT_HANDLER, que é definido da seguinte maneira:

  typedef NTSTATUS (*PCPFNEVENT_HANDLER)
  (
      IN PPCEVENT_REQUEST  EventRequest
  );

Ao chamar a rotina manipulador , o chamador passa um único parâmetro de chamada, que é um ponteiro para uma estrutura de PCEVENT_REQUEST alocada pelo chamador.

Comentários

A estrutura PCEVENT_ITEM especifica um item de evento específico em uma tabela de automação. A estrutura PCAUTOMATION_TABLE aponta para uma matriz de estruturas PCEVENT_ITEM .

No áudio WDM, o destino de uma solicitação de evento é uma instância de fixação ou um nó em um pin. Uma instância de filtro não pode ser o destino de uma solicitação de evento.

Requisitos

Confira também

PCAUTOMATION_TABLE

PCEVENT_REQUEST