IKsControl::KsEvent 方法 (ksproxy.h)

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;否则,返回错误代码。 如果调用成功,则事件位于驱动程序的事件列表中。

言论

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

IKsControl::KsEventEventData 参数包含 eventHandle.Event中的句柄。 当微型驱动程序调用 KsXxxGenerateEventsStreamClassStreamNotification时,可以等待句柄变得可用并获取通知。

要求

要求 价值
目标平台 DesktopMobile
标头 ksproxy.h (包括 Ksproxy.h)

另请参阅

KSEVENT

KSEVENTDATA

KsFilterGenerateEvents

KsPinGenerateEvents