KSMETHOD 结构

项目
02/12/2024

KSMETHOD 结构指定方法集中的单个内核流式处理方法。

KSEVENT、KSMETHOD 和 KSPROPERTY 结构是 KSIDENTIFIER 结构的别名。因此，它们的定义是相同的。

语法

struct KSMETHOD {
  GUID Set;
  ULONG Id;
  ULONG Flags;
};

成员

Set

指定标识内核流式处理方法集的 GUID。

有关方法集 GUID 的详细信息，请参阅下面的 “备注 ”部分。

Id

指定方法集的成员。

Flags

指定请求类型。另请参阅 KSMETHOD_ITEM) KSMETHOD_TYPE_Xxx标志 。

请求可以包含下表中列出的值的组合。

值	方法请求的类型
KSMETHOD_TYPE_BASICSUPPORT	指示查询微型驱动程序以确定它是否支持方法集的指定方法。
KSMETHOD_TYPE_SEND	指示微型驱动程序应执行指定的方法。客户端必须知道方法对给定参数的影响，即无论参数是从中读取、写入还是两者都不读取。微型驱动程序使用 KSMETHOD_ITEM 结构来指定方法对参数的影响。
KSMETHOD_TYPE_SETSUPPORT	指示查询微型驱动程序以确定它是否支持指定的方法集。
KSMETHOD_TYPE_TOPOLOGY	指示指定的方法的类型为 KSM_NODE，其中 NodeId 成员是拓扑节点的标识符。请勿自行设置此标志;相反，或者它与此列表中的其他标志一起。

注解

Microsoft 提供了多个系统定义的方法集 GUID。微型驱动程序在 Set 成员中指定其中一个 GUID。内核流式处理方法集通常以 KSMETHODSETID 前缀开头。内核流式处理方法集在 ks.h、 ksmedia.h、 bdamedia.h 以及可能的其他头文件中定义。

有关内核流事件的详细信息，请参阅 KS 属性、事件和方法。

客户端可以使用IOCTL_KS_METHOD请求和 KSMETHOD 结构对微型驱动程序处理的内核流式处理对象执行方法。有关详细信息，请参阅 KS 方法。