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::KsEvent 的 EventData 参数包含 eventHandle.Event中的句柄。 当微型驱动程序调用 KsXxxGenerateEvents 或 StreamClassStreamNotification时,可以等待句柄变得可用并获取通知。
要求
要求 | 价值 |
---|---|
目标平台 | DesktopMobile |
标头 | ksproxy.h (包括 Ksproxy.h) |