PFNKSDEVICECREATE 回调函数 (ks.h)
AVStream 微型驱动程序的 AVStrMiniDeviceAdd 例程会通知微型驱动程序 AVStream 的 PnP AddDevice 例程已完成。
语法
PFNKSDEVICECREATE Pfnksdevicecreate;
NTSTATUS Pfnksdevicecreate(
[in] PKSDEVICE Device
)
{...}
参数
[in] Device
指向 KSDEVICE 结构的指针，该结构描述功能设备对象 (刚刚创建的 FDO) 。
返回值
应返回STATUS_SUCCESS或尝试执行操作时返回的错误代码。 如果微型驱动程序返回失败状态，则相关的 AddDevice 调用也将失败。 有关更多详细信息，请参阅下面的“备注”部分。
注解
微型驱动程序在其KSDEVICE_DISPATCH结构的 Add 成员中指定此例程的地址。
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 (请参阅备注部分) |