WdfChildListUpdateChildDescriptionAsMissing 函数 (wdfchildlist.h)

  • 项目

[仅适用于 KMDF]

WdfChildListUpdateChildDescriptionAsMissing 方法通知框架指定的子设备当前已拔出或不可用。

语法

NTSTATUS WdfChildListUpdateChildDescriptionAsMissing(
  [in] WDFCHILDLIST                                 ChildList,
  [in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

参数

[in] ChildList

子列表对象的句柄。

[in] IdentificationDescription

指向调用方分配 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 结构的指针，该结构标识驱动程序提供的子 标识说明。

返回值

如果操作成功，WdfChildListUpdateChildDescriptionAsMissing 将返回STATUS_SUCCESS或NT_SUCCESS (状态) 等于 TRUE 的其他状态值。 否则，此方法可能会返回以下值之一：

返回代码 说明
STATUS_INVALID_PARAMETER
 输入参数无效。
STATUS_INVALID_DEVICE_REQUEST
 IdentificationDescription 指向的结构大小不正确。
STATUS_NO_SUCH_DEVICE
 在子列表中找不到指定的设备。
 

此方法还可能返回其他 NTSTATUS 值。

如果驱动程序提供无效的对象句柄，则会发生系统 bug 检查。

注解

即使驱动程序从未调用 WdfChildListAddOrUpdateChildDescriptionAsPresent 来报告设备存在，驱动程序也可以报告设备不可用。 在这种情况下， WdfChildListUpdateChildDescriptionAsMissing 方法仅返回STATUS_NO_SUCH_DEVICE。

如果要报告子列表中的所有设备都不可用，驱动程序只需调用 WdfChildListBeginScan，紧跟 WdfChildListEndScan，而不是为每个设备调用 WdfChildListUpdateChildDescriptionAsMissing 。

有关子设备和子列表的详细信息，请参阅 动态枚举。

示例

下面的代码示例通知框架具有指定序列号的子设备不可用。

PDO_IDENTIFICATION_DESCRIPTION  description;
NTSTATUS  status;

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT(
                                                 &description.Header,
                                                 sizeof(description)
                                                 );

description.SerialNo = SerialNo;
status = WdfChildListUpdateChildDescriptionAsMissing(
                                                     list,
                                                     &description.Header
                                                     );

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
标头 wdfchildlist.h (包括 Wdf.h)
Library Wdf01000.sys (请参阅框架库 Versioning.)
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另请参阅

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfChildListAddOrUpdateChildDescriptionAsPresent