KsInitializeDriver 函数 (ks.h)

项目
02/26/2024

KsInitializeDriver 函数初始化 AVStream 微型驱动程序的驱动程序对象。

语法

KSDDKAPI NTSTATUS KsInitializeDriver(
  [in]           PDRIVER_OBJECT            DriverObject,
  [in]           PUNICODE_STRING           RegistryPathName,
  [in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);

参数

[in] DriverObject

指向正在初始化的 AVStream 驱动程序 DRIVER_OBJECT 结构的指针。调用 KsInitializeDriver 的微型驱动程序 应使用操作系统传递给 DriverEntry 的驱动程序对象。

[in] RegistryPathName

指向 Unicode 字符串的指针，其中包含由操作系统传递到微型驱动程序 DriverEntry 函数的注册表路径字符串。

[in, optional] Descriptor

指向 KSDEVICE_DESCRIPTOR 结构的指针，该结构指定要初始化的设备的特征。如果此指针为 NULL，则创建具有默认特征且没有关联的筛选器工厂的设备。

返回值

KsInitializeDriver 返回 ioCreateDevice 或内部 AVStream 设备初始化例程返回STATUS_SUCCESS或相应的错误代码。

注解

此函数通常从 DriverEntry 调用。如果微型驱动程序传入设备描述符，AVStream 会在 AddDevice 时间创建具有指定特征的设备。自行执行设备初始化的微型驱动程序不一定需要调用 KsInitializeDriver。有关详细信息，请参阅初始化 AVStream 微型驱动程序。

要求

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