ExReinitializeResourceLite function (wdm.h)

Article
04/18/2022

The ExReinitializeResourceLite routine reinitializes an existing resource variable.

Syntax

NTSTATUS ExReinitializeResourceLite(
  [in, out] PERESOURCE Resource
);

Parameters

[in, out] Resource

A pointer to the caller-supplied resource variable to be reinitialized.

Return value

ExReinitializeResourceLite returns STATUS_SUCCESS.

Remarks

With a single call to ExReinitializeResource, a driver writer can replace three calls: one to ExDeleteResourceLite, another to ExAllocatePool, and a third to ExInitializeResourceLite. As contention for a resource variable increases, memory is dynamically allocated and attached to the resource in order to track this contention. As an optimization, ExReinitializeResourceLite retains and zeros this previously allocated memory.

The ERESOURCE structure is opaque; that is, the members are reserved for system use.

Requirements

Requirement	Value
Minimum supported client	Available starting with Windows 2000.
Target Platform	Universal
Header	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI compliance rules	HwStorPortProhibitedDDIs(storport)