KSDEVICE_DESCRIPTOR 结构 (ks.h)

项目
02/29/2024

KSDEVICE_DESCRIPTOR结构描述特定设备的特征。

语法

typedef struct _KSDEVICE_DESCRIPTOR {
  const KSDEVICE_DISPATCH   *Dispatch;
  ULONG                     FilterDescriptorsCount;
  const KSFILTER_DESCRIPTOR const * * FilterDescriptors;
  ULONG                     Version;
  ULONG                     Flags;
  PVOID                     Alignment;
} KSDEVICE_DESCRIPTOR, *PKSDEVICE_DESCRIPTOR;

成员

Dispatch

指向此设备的客户端调度表的指针。此调度表包含 PNP 消息的客户端调度函数，例如添加、启动、停止、删除。客户端不需要提供调度表，除非它们想要接收调度表中所述的 PNP 消息的回调。调度表的任何成员都可以为 NULL ，以指示客户端不希望接收该特定消息的通知。有关详细信息，请参阅 KSDEVICE_DISPATCH。

FilterDescriptorsCount

此成员包含将在 FilterDescriptors 成员中提供的此设备的筛选器描述符数。零是此成员的合法值;客户端可以使用 KsCreateFilterFactory 函数动态创建筛选器工厂，而不是在设备描述符中静态描述它们。

FilterDescriptors

指向筛选器描述符数组的指针，这些描述符描述此设备可以创建的筛选器。如果 FilterDescriptorsCount 为零，则此成员可能为 NULL。有关详细信息，请参阅 KSFILTER_DESCRIPTOR。

Version

ULONG 类型的值。这应该是下表中的一个且唯一的值，如果编写预版本0x100驱动程序，则此值应设置为零。

值	说明
KSDEVICE_DESCRIPTOR_VERSION	指示支持 KSDEVICE_DISPATCH 的 AVStrMiniDeviceQueryInterface 调度。
KSDEVICE_DESCRIPTOR_VERSION_2	指示支持 KSDEVICE_DESCRIPTOR 的 Flags 成员。