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 处理程序中使用 KsAddDeviceKsCreateDevice 时,才调用 KsInitializeDevice

要求

要求
最低受支持的客户端 适用于 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX。
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib
IRQL PASSIVE_LEVEL

另请参阅

DEVICE_OBJECT

DRIVER_OBJECT

IoAttachDeviceToDeviceStack

IoCreateDevice

KSDEVICE

KsAddDevice

KsCreateDevice

KsInitializeDriver

KsTerminateDevice