Метод IKsControl::KsEvent (ks.h)

Статья
08/07/2023

Метод IKsControl::KsEvent включает или отключает событие вместе с любыми другими определенными операциями поддержки, доступными в наборе событий.

Синтаксис

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

Параметры

Event

Указатель на структуру KSEVENT , которая описывает событие для включения события, и NULL для отключения события.

EventLength

Задает размер (в байтах) буфера при включении события и нулевой при отключении события.

EventData

Указатель на структуру KSEVENTDATA , содержащую данные для события и буферное пространство, которое получает данные для события.

DataLength

Задает размер буфера в байтах в EventData.

BytesReturned

Указатель на переменную, которая получает размер (в байтах) данных, которые KsEvent хранит в буфере в EventData.

Возвращаемое значение

Метод IKsControl::KsEvent возвращает то же значение, которое было бы возвращено, если бы событие было отправлено IOCTL.

Чтобы отключить событие, задайте для параметра Event значение NULL, для EventLength — ноль, а для EventData — указатель на структуру KSEVENTDATA , которая ранее использовалась для включения события.

Требования

Требование	Значение
Целевая платформа	DesktopMobile
Верхняя часть	ks.h (включая Ks.h)

См. также раздел

KSEVENT

KSEVENTDATA

Поделиться через