IKsControl：：KsEvent 方法 (ksproxy.h)

项目
02/29/2024

KsEvent 方法启用或禁用事件，以及事件集上可用的任何其他已定义支持操作。

语法

HRESULT KsEvent(
  [in, optional] PKSEVENT Event,
  [in]           ULONG    EventLength,
  [in, out]      LPVOID   EventData,
  [in]           ULONG    DataLength,
  [in, out]      ULONG    *BytesReturned
);

参数

[in, optional] Event

指向 KSEVENT 结构的指针，该结构描述要启用事件的事件， NULL 用于禁用事件。

[in] EventLength

启用 事件时缓冲区 的大小（以字节为单位），禁用事件时为零。

[in, out] EventData

指向 KSEVENTDATA 结构的指针，该结构包含事件的数据以及接收事件数据的缓冲区空间。

[in] DataLength

EventData 上的缓冲区的大小（以字节为单位）。

[in, out] BytesReturned

指向一个变量的指针，该变量接收 KsEvent 存储在 EventData 缓冲区中的数据的大小（以字节为单位）。

返回值

如果成功，则返回 NOERROR;否则，将返回错误代码。如果调用成功，事件将位于驱动程序的事件列表中。

注解

若要禁用事件，请将 Event 设置为 NULL， 将 EventLength 设置为零，将 EventData 设置为指向先前用于启用事件的 KSEVENTDATA 结构的指针。

IKsControl：：KsEvent 的 EventData 参数包含 EventHandle.Event 中的句柄。可以等待句柄变为可用，并在微型驱动程序调用 KsXxxGenerateEvents 或 StreamClassStreamNotification 时获取通知。