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
指向 DEVICE_OBJECT 结构的指针,该结构表示要初始化的设备的 WDM 功能设备对象。
通常,这是从 IoCreateDevice 调用返回的。 直接调用此函数的微型驱动程序负责调用 IoCreateDevice 并将自身附加到设备堆栈。
[in] PhysicalDeviceObject
指向 DEVICE_OBJECT 结构的指针,该结构表示要初始化的设备的 WDM 物理设备对象。
[in] NextDeviceObject
指向设备堆栈中下一 个DEVICE_OBJECT 结构的指针,由调用 IoAttachDeviceToDeviceStack 确定。
[in, optional] Descriptor
指向描述正在初始化的设备特征 的KSDEVICE_DESCRIPTOR 结构的指针。 如果此参数为 NULL,则设备使用默认特征进行初始化,并且没有关联的筛选器工厂。
返回值
如果成功初始化设备,KsInitializeDevice 将返回STATUS_SUCCESS。 否则,它将返回相应的错误代码。
注解
大多数微型驱动程序不会直接调用此函数。 仅当微型驱动程序不使用 KsInitializeDriver 进行初始化、独立处理 AddDevice 且不在其 AddDevice 处理程序中使用 KsAddDevice 或 KsCreateDevice 时,才调用 KsInitializeDevice。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 适用于 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX。 |
目标平台 | 通用 |
标头 | ks.h (包括 Ks.h) |
Library | Ks.lib |
IRQL | PASSIVE_LEVEL |