WdfFdoGetDefaultChildList 函数 (wdffdo.h)
[仅适用于 KMDF]
WdfFdoGetDefaultChildList 方法将句柄返回到指定设备的默认子列表。
语法
WDFCHILDLIST WdfFdoGetDefaultChildList(
[in] WDFDEVICE Fdo
);
参数
[in] Fdo
框架设备对象的句柄。
返回值
如果操作成功， WdfFdoGetDefaultChildList 将返回与 Fdo 指定的设备关联的默认子列表的句柄。 否则， 方法返回 NULL。
如果驱动程序提供无效的对象句柄，则会发生系统 bug 检查。
注解
在调用 WdfFdoGetDefaultChildList 之前，驱动程序必须调用 WdfFdoInitSetDefaultChildListConfig 来配置默认子列表。 否则， WdfFdoGetDefaultChildList 返回 NULL。
有关子列表的详细信息，请参阅 动态枚举。
示例
下面的代码示例获取设备的默认子列表的句柄。
WDFCHILDLIST list;
list = WdfFdoGetDefaultChildList(Device);
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 最低 KMDF 版本 | 1.0 |
| 标头 | wdffdo.h (包括 Wdf.h) |
| Library | Wdf01000.sys (请参阅框架库版本控制.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 符合性规则 | DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) |