Método IKsControl::KsEvent (ks.h)

O método IKsControl::KsEvent habilita ou desabilita um evento, juntamente com quaisquer outras operações de suporte definidas disponíveis em um conjunto de eventos.

Sintaxe

NTSTATUS KsEvent(
  PKSEVENT Event,
  ULONG    EventLength,
  PVOID    EventData,
  ULONG    DataLength,
  ULONG    *BytesReturned
);

Parâmetros

Event

Ponteiro para uma estrutura KSEVENT que descreve um evento para habilitar o evento e NULL para desabilitar o evento.

EventLength

Especifica o tamanho, em bytes, do buffer em Evento quando o evento está habilitado e zero quando o evento está desabilitado.

EventData

Ponteiro para uma estrutura KSEVENTDATA que contém dados para o evento e o espaço de buffer que recebe dados para o evento.

DataLength

Especifica o tamanho, em bytes, do buffer em EventData.

BytesReturned

Ponteiro para uma variável que recebe o tamanho, em bytes, dos dados que o KsEvent armazena no buffer em EventData.

Retornar valor

O método IKsControl::KsEvent retorna o mesmo valor que seria retornado se o evento tivesse sido enviado pelo IOCTL.

Comentários

Para desabilitar um evento, defina Event como NULL, EventLength como zero e EventData como o ponteiro para a estrutura KSEVENTDATA que foi usada anteriormente para habilitar o evento.

Requisitos

Requisito Valor
Plataforma de Destino DesktopMobile
Cabeçalho ks.h (inclua Ks.h)

Confira também

KSEVENT

KSEVENTDATA