KsAddDevice 函数 (ks.h)

KsAddDevice 函数是 KsInitializeDriver安装的默认 AddDevice 处理程序。

语法

KSDDKAPI NTSTATUS KsAddDevice(
  [in] PDRIVER_OBJECT DriverObject,
  [in] PDEVICE_OBJECT PhysicalDeviceObject
);

参数

[in] DriverObject

指向微型驱动程序的 WDM 驱动程序对象的指针。

[in] PhysicalDeviceObject

指向 WDM 物理设备对象的指针。

返回值

返回STATUS_SUCCESS指示设备已成功创建或从 IoCreateDeviceKsInitializeDevice的错误状态。

言论

通常,AVStream 微型驱动程序不会直接调用此函数。

有关详细信息,请参阅 ADDDevice 例程 for AVStream Minidrivers

KsAddDevice 提取从调用分配给 KsInitializeDriver 的设备扩展中存储的设备描述符,并创建其描述的设备。 如果 KsInitializeDriver 不用于初始化驱动程序,则此函数将创建一个具有默认特征且无筛选器工厂的设备。 微型驱动程序始终可以选择直接调用 KsCreateDevice,在这种情况下,AVStream 不使用驱动程序扩展。 由于 KsAddDevice 调用 KsCreateDevice,因此调用 KsAddDevice 的驱动程序不应单独调用 KsCreateDevice

要求

要求 价值
最低支持的客户端 Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。
目标平台 普遍
标头 ks.h (包括 Ks.h)
Ks.lib
IRQL PASSIVE_LEVEL

另请参阅

DEVICE_OBJECT

DRIVER_OBJECT

KSDEVICE

KsCreateDevice

KsDispatchIrp

KsInitializeDevice

KsInitializeDriver