Export (0) Print
Expand All
Expand Minimize

RtlAreBitsSet routine

The RtlAreBitsSet routine determines whether a given range of bits within a bitmap variable is set.

Syntax


BOOLEAN RtlAreBitsSet(
  _In_  PRTL_BITMAP BitMapHeader,
  _In_  ULONG StartingIndex,
  _In_  ULONG Length
);

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 tested. This is a zero-based value indicating the position of the first bit in the range.

Length [in]

Specifies how many bits to test.

Return value

RtlAreBitsSet returns TRUE if Length consecutive bits beginning at StartingIndex are set (that is, all the bits from StartingIndex to (StartingIndex + Length)). It returns FALSE if any bit in the given range is clear, if the given range is not a proper subset of the bitmap, or if the given Length is zero.

Remarks

Callers of RtlAreBitsSet 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, RtlAreBitsSet 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
RtlCheckBit
RtlFindSetBits
RtlInitializeBitMap
RtlSetAllBits

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft