WdfIoResourceListCreate function (wdfresource.h)
[Applies to KMDF only]
The WdfIoResourceListCreate method creates an empty logical configuration, which can be populated and added to a resource requirements list.
Syntax
NTSTATUS WdfIoResourceListCreate(
[in] WDFIORESREQLIST RequirementsList,
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] WDFIORESLIST *ResourceList
);
Parameters
[in] RequirementsList
A handle to a framework resource-requirements-list object that represents a device's resource requirements list.
[in, optional] Attributes
A pointer to a caller-allocated WDF_OBJECT_ATTRIBUTES structure that contains attributes for the new object. (The structure's ParentObject member must be NULL.) This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.
[out] ResourceList
A handle to a framework resource-range-list object that represents the new logical configuration.
Return value
WdfIoResourceListCreate returns STATUS_SUCCESS if the operation succeeds.
For additional return values, see Framework Object Creation Errors.
A system bug check occurs if the driver supplies an invalid object handle.
Remarks
For more information about resource requirements lists and logical configurations, see Hardware Resources for Framework-Based Drivers.
The caller-specified resource-requirements-list object becomes the parent of the new resource-range-list object. The driver cannot change this parent, and the ParentObject member or the WDF_OBJECT_ATTRIBUTES structure must be NULL.
Examples
For a code example that uses WdfIoResourceListCreate, see WdfIoResourceRequirementsListAppendIoResList.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Universal |
| Minimum KMDF version | 1.0 |
| Header | wdfresource.h (include Wdf.h) |
| Library | Wdf01000.sys (see Framework Library Versioning.) |
| IRQL | <=DISPATCH_LEVEL |
| DDI compliance rules | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |