WdfObjectCreate 函数 (wdfobject.h)
[适用于 KMDF 和 UMDF]
WdfObjectCreate 方法创建一个常规框架对象。
语法
NTSTATUS WdfObjectCreate(
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] WDFOBJECT *Object
);
参数
[in, optional] Attributes
指向 WDF_OBJECT_ATTRIBUTES 结构的指针,该结构包含新对象的驱动程序提供的属性。 此参数是可选的,可以WDF_NO_OBJECT_ATTRIBUTES。
[out] Object
指向接收新框架对象的句柄的位置的指针。
返回值
如果操作成功,WdfObjectCreate 将返回STATUS_SUCCESS。 有关其他返回值的列表,请参阅 框架对象创建错误。
此方法还可能返回其他 NTSTATUS 值。
注解
默认情况下,新的常规框架对象的父对象是 WdfDriverCreate 方法创建的框架驱动程序对象。 可以使用 WDF_OBJECT_ATTRIBUTES 结构的 ParentObject 成员来指定不同的父级。 框架在删除父对象时删除常规对象。 如果驱动程序未更改默认父级,则驱动程序应在使用完对象后删除常规对象;否则,对象将一直保留,直到 I/O 管理器卸载驱动程序。
有关 WdfObjectCreate 方法的详细信息,请参阅 使用常规框架对象。
有关框架对象层次结构的清理规则的详细信息,请参阅 框架对象生命周期。
示例
下面的代码示例初始化WDF_OBJECT_ATTRIBUTES结构并创建一个常规框架对象。
WDF_OBJECT_ATTRIBUTES Attributes;
WDFOBJECT Object;
WDF_OBJECT_ATTRIBUTES_INIT(&Attributes);
status = WdfObjectCreate(
&Attributes,
&Object
);
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
标头 | wdfobject.h (包括 Wdf.h) |
Library | Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF) |
IRQL | <=DISPATCH_LEVEL |
DDI 符合性规则 | DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) |