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 调用例程。

此例程是可选的。

要求

另请参阅

KSDEVICE_DISPATCH