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(请参阅“备注”部分)

另请参阅

KSDEVICE_DISPATCH