struttura PCEVENT_ITEM (portcls.h)

La struttura PCEVENT_ITEM viene usata per descrivere un evento supportato da un determinato filtro, pin o nodo.

Sintassi

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

Members

Set

Specifica il set di eventi. Questo membro è un puntatore a un GUID che identifica in modo univoco il set di eventi. Vedere l'elenco dei GUID del set di eventi nei set di eventi dei driver audio.

Id

Specifica l'ID evento. Questo membro identifica un elemento evento all'interno del set di eventi. Se il set di eventi contiene N elementi, gli ID evento validi sono numeri interi nell'intervallo compreso tra 0 e N-1.

Flags

Specifica il tipo di evento. Questo membro è impostato su uno dei valori seguenti:

PCEVENT_ITEM_FLAG_ENABLE

Indica che la notifica degli eventi deve essere abilitata per questo tipo di evento. Il driver deve continuare la notifica degli eventi fino a quando il client non lo disabilita in modo esplicito.

PCEVENT_ITEM_FLAG_ONESHOT

Indica che la notifica degli eventi deve essere abilitata solo per l'occorrenza successiva di questo evento. Il client non (e non deve) disabilitare l'evento dopo che si è verificato.

PCEVENT_ITEM_FLAG_BASICSUPPORT

Se il client specifica questo flag, il driver restituisce STATUS_SUCCESS se supporta l'evento e un codice di errore in caso contrario.

Handler

Puntatore alla routine del gestore eventi del driver miniport. Questo membro è un puntatore a funzione di tipo PCPFNEVENT_HANDLER, definito come segue:

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

Quando si chiama la routine Handler , il chiamante passa un singolo parametro di chiamata, ovvero un puntatore a una struttura di PCEVENT_REQUEST allocata dal chiamante.

Commenti

La struttura PCEVENT_ITEM specifica un particolare elemento evento in una tabella di automazione. La struttura PCAUTOMATION_TABLE punta a una matrice di strutture PCEVENT_ITEM .

Nell'audio WDM, la destinazione per una richiesta di evento è un'istanza del pin o un nodo su un pin. Un'istanza di filtro non può essere la destinazione di una richiesta di evento.

Requisiti

Vedi anche

PCAUTOMATION_TABLE

PCEVENT_REQUEST