KsPinGenerateEvents 函数 (ks.h)

  • 项目

KsPinGenerateEvents 函数生成位于 Pin 事件列表中的指示类型的事件。

语法

void KsPinGenerateEvents(
  [in]           PKSPIN                     Pin,
  [in, optional] const GUID                 *EventSet,
  [in]           ULONG                      EventId,
  [in]           ULONG                      DataSize,
  [in, optional] PVOID                      Data,
  [in, optional] PFNKSGENERATEEVENTCALLBACK CallBack,
  [in, optional] PVOID                      CallBackContext
);

参数

[in] Pin

指向要生成事件的 KSPIN 结构的指针。

[in, optional] EventSet

指向要匹配的事件集 GUID 的指针，以确定要生成的事件。 如果此参数为 NULL，则不会在确定匹配事件时考虑设置 GUID。

[in] EventId

要匹配的事件 ID，以确定要生成的事件。

[in] DataSize

用于生成数据事件的数据的大小（以字节为单位）。

[in, optional] Data

指向数据缓冲区的指针。 指定是否生成数据事件。

[in, optional] CallBack

指向调用方指定的函数的指针，该函数被调用以确定是否应生成给定事件。 如果 为 NULL，则不执行回调验证以确定是否应仅 (使用 *EventSet *和 EventId) 生成事件。 原型如下：

BOOLEAN CallBack
(IN PVOID Context,
    IN PKSEVENT_ENTRY EventEntry);

KsPinGenerateEvents 将 CallBackContext 参数作为回调的 Context 参数传递不变。 如果应生成 EventEntry，则回调函数返回 TRUE。 否则，它将返回 FALSE。

[in, optional] CallBackContext

指向传递给回调函数 CallBack 的调用方指定上下文的指针。

返回值

无

备注

调用此函数时，微型驱动程序必须将 Data 和 CallBackContext 置于锁定的不可分页数据段中。 调用回叫是在DISPATCH_LEVEL进行的。 回调函数必须位于锁定的段中，并且必须准备好在 IRQL = DISPATCH_LEVEL 运行。 请注意， 仅 DX8 中还有一个问题： EventSet 必须位于锁定的数据段中。

这是对 KsGenerateEvents 的内联函数调用，用于执行必要的类型转换。 微型驱动程序通常应调用此版本，而不是直接调用 KsGenerateEvents。

如果满足以下三个条件，则会生成事件：

  • 事件存在于 *Pin 的 *事件列表中，*EventId *与事件的 ID 匹配。

  • EventSet 与事件的设置 GUID 匹配，或者为 NULL。

  • *CallBack *为 NULL 或授权匹配项。

有关详细信息，请参阅 AVStream 中的事件处理 和 KS 事件。

要求

要求 值
最低受支持的客户端 适用于 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX。
目标平台 桌面
标头 ks.h (包括 Ks.h)
Library Ks.lib
IRQL <=DISPATCH_LEVEL (请参阅备注)

另请参阅

KSEVENT_ENTRY

KsAddEvent

KsFilterGenerateEvents

KsGenerateEvents