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 处理程序中使用 KsAddDeviceKsCreateDevice

要求

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

另请参阅

DEVICE_OBJECT

DRIVER_OBJECT

IoAttachDeviceToDeviceStack

IoCreateDevice

KSDEVICE

KsAddDevice

KsCreateDevice

KsInitializeDriver

KsTerminateDevice