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) |
图书馆 | Wdf01000.sys(请参阅框架库版本控制。 |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | DriverCreate(kmdf),KmdfIrql(kmdf),KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf) |