PFNKSDEVICECREATE 回调函数 (ks.h)
AVStream 微型驱动程序的 AVStrMiniDeviceAdd 例程通知 AVStream 的 PnP AddDevice 例程已完成。
语法
PFNKSDEVICECREATE Pfnksdevicecreate;
NTSTATUS Pfnksdevicecreate(
[in] PKSDEVICE Device
)
{...}
参数
[in] Device
指向 KSDEVICE 结构的指针,该结构描述刚刚创建的功能设备对象(FDO)。
返回值
应返回STATUS_SUCCESS或尝试执行作时返回的错误代码。 如果微型驱动程序返回失败状态,则相关 AddDevice 调用也将失败。 有关更多详细信息,请参阅下面的“备注”部分。
言论
微型驱动程序在 添加 KSDEVICE_DISPATCH 结构的 成员中指定此例程的地址。
AVStream 在 KSDEVICE 初始化时间,从其默认 AddDevice 例程调用 AVStrMiniDeviceAdd。 在调用此例程时,已创建 WDM 设备对象(DEVICE_OBJECT),KSDEVICE 结构已实例化和初始化,并且已分配 KS 设备标头。
微型驱动程序可以使用此例程将上下文信息与 AVStream 设备对象相关联,或初始化设备扩展。
如果此例程返回不成功的状态代码,AVStream 的 AddDevice 例程将失败。 STATUS_PENDING不是法律返回代码,因为没有涉及 IRP。 例程仅在 IRQL = PASSIVE_LEVEL调用。
此例程是可选的。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。 |
目标平台 | 桌面 |
标头 | ks.h (包括 Ks.h) |
IRQL | PASSIVE_LEVEL(请参阅“备注”部分) |