Export (0) Print
Expand All
Expand Minimize

RtlSetBits routine

The RtlSetBits routine sets all bits in a given range of a given bitmap variable.

Syntax


VOID RtlSetBits(
  _In_  PRTL_BITMAP BitMapHeader,
  _In_  ULONG StartingIndex,
  _In_  ULONG NumberToSet
);

Parameters

BitMapHeader [in]

A pointer to the RTL_BITMAP structure that describes the bitmap. This structure must have been initialized by the RtlInitializeBitMap routine.

StartingIndex [in]

Specifies the start of the bit range to be set. This is a zero-based value indicating the position of the first bit in the range.

NumberToSet [in]

Specifies how many bits to set.

Return value

None

Remarks

RtlSetBits simply returns control if the input NumberToSet is zero. StartingIndex plus NumberToSet must be less than or equal to BitMapHeader->SizeOfBitMap.

Callers of RtlSetBits must be running at IRQL <= APC_LEVEL if the memory that contains the bitmap variable is pageable or the memory at BitMapHeader is pageable. Otherwise, RtlSetBits can be called at any IRQL.

Requirements

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

<= APC_LEVEL (See Remarks section)

See also

RtlAreBitsClear
RTL_BITMAP
RtlFindClearBitsAndSet
RtlFindClearRuns
RtlFindFirstRunClear
RtlFindLastBackwardRunClear
RtlFindLongestRunClear
RtlFindNextForwardRunClear
RtlInitializeBitMap
RtlSetAllBits
RtlNumberOfClearBits

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft