Compartilhar via


KSEVENT_ITEM estrutura (ks.h)

A estrutura KSEVENT_ITEM descreve o suporte de um minidriver para um evento específico dentro de um conjunto de eventos.

Sintaxe

typedef struct {
  ULONG            EventId;
  ULONG            DataInput;
  ULONG            ExtraEntryData;
  PFNKSADDEVENT    AddHandler;
  PFNKSREMOVEEVENT RemoveHandler;
  PFNKSHANDLER     SupportHandler;
} KSEVENT_ITEM, *PKSEVENT_ITEM;

Membros

EventId

Especifica a ID exclusiva do evento dentro do conjunto de eventos.

DataInput

Especifica o tamanho em bytes de dados de evento. Os dados do evento começam com uma estrutura de KSEVENTDATA que descreve como o cliente deve ser notificado quando o evento ocorre, opcionalmente seguido por quaisquer parâmetros adicionais que especifiquem quando o evento ocorre. Deve ter pelo menos tamanho de(KSEVENTDATA).

ExtraEntryData

Especifica o tamanho em bytes de qualquer memória adicional que o sistema deve alocar para cada solicitação de habilitação para esse evento. O driver usa essa memória para armazenar todos os dados necessários para acompanhar a solicitação de evento. A memória é alocada diretamente após o evento habilitar a estrutura de KSEVENT_ENTRY da solicitação.

AddHandler

Ponteiro para um minidriver fornecido AVStrMiniAddEvent rotina de retorno de chamada. Não usado pelo driver de classe de fluxo. Somente para minidrivers AVStream.

RemoveHandler

Ponteiro para um minidriver fornecido AVStrMiniRemoveEvent rotina de retorno de chamada. Não usado pelo driver de classe de fluxo. Somente para minidrivers AVStream.

SupportHandler

Não usado pelo driver de classe de fluxo.

Observações

Um minidriver que especifica o AddHandler e removeHandler membros e não limpa corretamente os eventos pode causar um vazamento de recurso (memória/identificador).

Requisitos

Requisito Valor
cabeçalho ks.h (incluir Ks.h)

Consulte também

IOCTL_KS_DISABLE_EVENT

KSEVENTDATA

KSEVENT_ENTRY

KsDefaultAddEventHandler