The RtlFindLongestRunClear routine searches for the largest contiguous range of clear bits within a given bitmap.
- BitMapHeader [in]
- StartingIndex [out]
Pointer to a variable in which the starting index of the longest clear run in the bitmap is returned. This is a zero-based value indicating the bit position of the first clear bit in the returned range.
RtlFindLongestRunClear returns either the number of bits in the run beginning at StartingIndex, or zero if it cannot find a run of clear bits within the bitmap.
A returned run can have a single clear bit.
Callers of RtlFindLongestRunClear 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, RtlFindLongestRunClear can be called at any IRQL.
|Available starting with Windows 2000.|
|<= APC_LEVEL (See Remarks section)|