ClfsAllocReservedLog function (wdm.h)

The ClfsAllocReservedLog routine reserves space in a marshalling area for a set of records.

Syntax

CLFSUSER_API NTSTATUS ClfsAllocReservedLog(
  [in] PVOID     pvMarshalContext,
  [in] ULONG     cRecords,
  [in] PLONGLONG pcbAdjustment
);

Parameters

[in] pvMarshalContext

A pointer to an opaque context that represents a marshalling area. The caller previously obtained this pointer by calling ClfsCreateMarshallingArea.

[in] cRecords

The number of records in the set. This value must match the value of cRecords previously passed to ClfsAlignReservedLog.

[in] pcbAdjustment

A pointer to a LONGLONG-typed variable that supplies the size, in bytes, of the reservation that will hold all the records in the set. The caller previously obtained this size by calling ClfsAlignReservedLog.

Return value

ClfsAllocReservedLog returns STATUS_SUCCESS if it succeeds; otherwise, it returns one of the error codes defined in Ntstatus.h.

Remarks

For an explanation of CLFS concepts and terminology, see Common Log File System.

Requirements

Requirement Value
Minimum supported client Available in Windows Server 2003 R2, Windows Vista, and later versions of Windows.
Target Platform Desktop
Header wdm.h (include Wdm.h)
Library Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

See also

ClfsAlignReservedLog