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指示设备已成功创建或来自 IoCreateDevice 或 KsInitializeDevice 的错误状态。
注解
通常，AVStream 微型驱动程序不会直接调用此函数。
有关详细信息，请参阅 AddDevice Routine for AVStream Minidrivers。
KsAddDevice 提取从调用 KsInitializeDriver 分配的设备扩展中存储的设备描述符，并创建它描述的设备。 如果未使用 KsInitializeDriver 初始化驱动程序，则此函数将创建具有默认特征且没有筛选器工厂的设备。 微型驱动程序始终可以选择直接调用 KsCreateDevice ，在这种情况下，AVStream 不使用驱动程序扩展。 由于 KsAddDevice 调用 KsCreateDevice，因此调用 KsAddDevice 的 驱动程序不应单独调用 KsCreateDevice 。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX 中可用。 |
| 目标平台 | 通用 |
| 标头 | ks.h (包括 Ks.h) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |