KsInitializeDevice 函数 (ks.h)
AVStream 调用 KsInitializeDevice 函数,从 KsCreateDevice中初始化 AVStream 设备类。
语法
KSDDKAPI NTSTATUS KsInitializeDevice(
[in] PDEVICE_OBJECT FunctionalDeviceObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in] PDEVICE_OBJECT NextDeviceObject,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);
参数
[in] FunctionalDeviceObject
指向表示要初始化设备的 WDM 功能设备对象的 DEVICE_OBJECT 结构的指针。
通常,这是从 IoCreateDevice 调用返回的。 直接调用此函数的微型驱动程序负责调用 IoCreateDevice 并将其附加到设备堆栈。
[in] PhysicalDeviceObject
指向表示要初始化设备的 WDM 物理设备对象的 DEVICE_OBJECT 结构的指针。
[in] NextDeviceObject
指向设备堆栈中下一个 DEVICE_OBJECT 结构的指针,该结构由调用 IoAttachDeviceToDeviceStack确定。
[in, optional] Descriptor
指向描述正在初始化的设备特征的 KSDEVICE_DESCRIPTOR 结构的指针。 如果此参数 NULL,则会使用默认特征初始化设备,并且没有关联的筛选器工厂。
返回值
KsInitializeDevice 在成功初始化设备时返回STATUS_SUCCESS。 否则,它将返回适当的错误代码。
言论
大多数微型驱动程序不直接调用此函数。 仅当微型驱动程序不使用 KsInitializeDriver 初始化时,才调用 KsInitializeDevice, 单独处理 AddDevice,并且不会在其 AddDevice 处理程序中使用 KsAddDevice 或 KsCreateDevice。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。 |
目标平台 | 普遍 |
标头 | ks.h (包括 Ks.h) |
库 | Ks.lib |
IRQL | PASSIVE_LEVEL |