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

El método IKsControl::KsEvent habilita o deshabilita un evento, junto con cualquier otra operación de soporte técnico definida disponible en un conjunto de eventos.

Sintaxis

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

Parámetros

Event

Puntero a una estructura KSEVENT que describe un evento para permitir que el evento y NULL deshabiliten el evento.

EventLength

Especifica el tamaño, en bytes, del búfer en Event cuando el evento está habilitado y cero cuando el evento está deshabilitado.

EventData

Puntero a una estructura KSEVENTDATA que contiene datos para el evento y el espacio de búfer que recibe los datos del evento.

DataLength

Especifica el tamaño, en bytes, del búfer en EventData.

BytesReturned

Puntero a una variable que recibe el tamaño, en bytes, de los datos que KsEvent almacena en el búfer en EventData.

Valor devuelto

El método IKsControl::KsEvent devuelve el mismo valor que se devolvería si el evento hubiera sido enviado por IOCTL.

Comentarios

Para deshabilitar un evento, establezca Event en NULL, EventLength en cero y EventData en el puntero a la estructura KSEVENTDATA que se usó anteriormente para habilitar el evento.

Requisitos

Requisito Value
Plataforma de destino DesktopMobile
Encabezado ks.h (incluya Ks.h)

Consulte también

KSEVENT

KSEVENTDATA