KsInitializeDriver 函数 (ks.h)
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 |