KSDEVICE 结构 (ks.h)

项目
02/29/2024

KSDEVICE 结构描述由 AVStream 管理的 WDM 功能设备。

语法

typedef struct _KSDEVICE {
  const KSDEVICE_DESCRIPTOR *Descriptor;
  KSOBJECT_BAG              Bag;
  PVOID                     Context;
  PDEVICE_OBJECT            FunctionalDeviceObject;
  PDEVICE_OBJECT            PhysicalDeviceObject;
  PDEVICE_OBJECT            NextDeviceObject;
  BOOLEAN                   Started;
  SYSTEM_POWER_STATE        SystemPowerState;
  DEVICE_POWER_STATE        DevicePowerState;
} KSDEVICE, *PKSDEVICE;

成员

Descriptor

指向 KSDEVICE_DESCRIPTOR 结构的指针，该结构描述设备的特征及其支持的静态筛选器。

Bag

此成员指定与与设备关联的 PVOID) 类型等效的KSOBJECT_BAG (。请参阅对象包。

Context

指向包含设备的上下文信息的内存位置的指针。 AVStream 在此成员中存储指向设备扩展的指针，以便微型驱动程序在 AVStrMiniDeviceStart 中分配设备扩展。为上下文分配的内存应使用 KsAddItemToObjectBag 放置在对象包中。 上下文 在创建时初始化为 NULL 。

FunctionalDeviceObject

指向 DEVICE_OBJECT 结构的指针，该结构是所描述设备的 WDM 功能设备对象。

PhysicalDeviceObject

指向 DEVICE_OBJECT 结构的指针，该结构是所描述设备的 WDM 物理设备对象。

NextDeviceObject

指向 DEVICE_OBJECT 结构的指针，该结构是 IoAttachDeviceToDeviceStack 确定的驱动程序堆栈中的下一个设备。

Started

此成员指示此特定设备是否已启动。如果 为 TRUE，则设备已启动。如果 为 FALSE，则表示设备尚未启动。此标志在处理IRP_MN_START_DEVICE 期间设置，并在处理IRP_MN_STOP_DEVICE期间重置。未启动的设备返回STATUS_DEVICE_NOT_READY以响应所有创建筛选器的请求。

SystemPowerState

一个SYSTEM_POWER_STATE类型的值，指示系统的当前电源状态。 SYSTEM_POWER_STATE值在 wdm.h 中定义。

DevicePowerState

一个DEVICE_POWER_STATE类型的值，指示设备的当前电源状态。 DEVICE_POWER_STATE值在 wdm.h 中定义。

注解

如果客户端必须实现 AVStream 未提供的特定 PnP 或电源管理行为，则通常使用此结构。指向 KSDEVICE 结构的指针是 KSDEVICE_DISPATCH中指定的所有调度例程的第一个参数，客户端可以使用上下文信息为这些例程附加自己的上下文。此外，客户端可以通过调用 KsGetDeviceForDeviceObject 从 WDM 设备对象指针获取指向 KSDEVICE 结构的指针。

如上所述， 上下文 在创建时初始化为 NULL 。但是，此 KSDEVICE 结构的后代将其对应的 Context 成员设置为父对象的 Context 成员的值。创建新对象时会发生这种情况。有关详细信息，请参阅 AVStream 对象层次结构和对象包。另请参阅可能的 AVStream 后代对象的参考页： KSFILTERFACTORY、 KSFILTER 和 KSPIN。

要求

要求	值
最低受支持的客户端	适用于 Microsoft Windows XP 及更高版本的操作系统以及 Microsoft DirectX 8.0 及更高版本。
标头	ks.h (包括 Ks.h)