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) |