estructura PCEVENT_ITEM (portcls.h)

La estructura PCEVENT_ITEM se usa para describir un evento compatible con un filtro, un pin o un nodo determinados.

Sintaxis

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

Miembros

Set

Especifica el conjunto de eventos. Este miembro es un puntero a un GUID que identifica de forma única el conjunto de eventos. Consulte la lista de GUID del conjunto de eventos en Conjuntos de eventos de controladores de audio.

Id

Especifica el identificador de evento. Este miembro identifica un elemento de evento dentro del conjunto de eventos. Si el conjunto de eventos contiene N elementos, los identificadores de evento válidos son enteros en el intervalo de 0 a N-1.

Flags

Especifica el tipo de evento. Este miembro se establece en uno de los valores siguientes:

PCEVENT_ITEM_FLAG_ENABLE

Indica que la notificación de eventos debe estar habilitada para este tipo de evento. El controlador debe continuar la notificación de eventos hasta que el cliente la deshabilite explícitamente.

PCEVENT_ITEM_FLAG_ONESHOT

Indica que la notificación de eventos se debe habilitar solo para la siguiente aparición de este evento. El cliente no deshabilita (y no debe) el evento una vez que se ha producido.

PCEVENT_ITEM_FLAG_BASICSUPPORT

Si el cliente especifica esta marca, el controlador devuelve STATUS_SUCCESS si admite el evento y un código de error si no lo hace.

Handler

Puntero a la rutina del controlador de eventos del controlador de minipuerto. Este miembro es un puntero de función de tipo PCPFNEVENT_HANDLER, que se define de la siguiente manera:

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

Al llamar a la rutina Handler , el llamador pasa un único parámetro de llamada, que es un puntero a una estructura de PCEVENT_REQUEST asignada por el autor de la llamada.

Comentarios

La estructura PCEVENT_ITEM especifica un elemento de evento determinado en una tabla de automatización. La estructura PCAUTOMATION_TABLE apunta a una matriz de estructuras de PCEVENT_ITEM .

En el audio WDM, el destino de una solicitud de evento es una instancia de patilla o un nodo en una patilla. Una instancia de filtro no puede ser el destino de una solicitud de evento.

Requisitos

Requisito	Valor
Header	portcls.h (incluir Portcls.h)

Consulte también

PCAUTOMATION_TABLE

PCEVENT_REQUEST