KsInitializeDevice 函数 (ks.h)

项目
08/07/2023

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