WdfIoResourceRequirementsListRemove function (wdfresource.h)

Article
04/18/2022

[Applies to KMDF only]

The WdfIoResourceRequirementsListRemove method removes a logical configuration from a resource requirements list.

Syntax

void WdfIoResourceRequirementsListRemove(
  [in] WDFIORESREQLIST RequirementsList,
  [in] ULONG           Index
);

Parameters

[in] RequirementsList

A handle to a framework resource-requirements-list object that represents a device's resource requirements list.

[in] Index

A zero-based value that is used as an index into the resource requirements list that RequirementsList specifies.

Return value

None

Remarks

A bug check occurs if the driver supplies an invalid object handle.

The WdfIoResourceRequirementsListRemove method removes the logical configuration that is associated with the index value that the Index parameter specifies.

When WdfIoResourceRequirementsListRemove removes the logical configuration that has the index value n, the index value of the next logical configuration changes from n+1 to n.

For more information about resource requirements lists, see Hardware Resources for Framework-Based Drivers.

Examples

The following code example removes the second logical configuration from a resource requirements list.

NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{
...
    WdfIoResourceRequirementsListRemove(
                                        RequirementsList,
                                        1
                                        );
...
}

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)

Share via