Поделиться через


Функция RtlSetBits (wdm.h)

Подпрограмма RtlSetBits задает все биты в заданном диапазоне заданной переменной растрового изображения.

Синтаксис

NTSYSAPI VOID RtlSetBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       NumberToSet
);

Параметры

[in] BitMapHeader

Указатель на структуру RTL_BITMAP , описывающую растровое изображение. Эта структура должна быть инициализирована подпрограммой RtlInitializeBitMap .

[in] StartingIndex

Указывает начало заданного битового диапазона. Это отсчитываемое от нуля значение, указывающее положение первого бита в диапазоне.

[in] NumberToSet

Указывает, сколько битов необходимо задать.

Возвращаемое значение

None

Remarks

RtlSetBits просто возвращает элемент управления, если входной параметр NumberToSet равен нулю. Значение StartingIndex и NumberToSet должно быть меньше или равно BitMapHeader-SizeOfBitMap>.

Вызывающие элементы RtlSetBits должны выполняться в irQL <= APC_LEVEL, если память, содержащая переменную растрового изображения, является страничной или память в BitMapHeader является страничной. В противном случае RtlSetBits можно вызвать в любом IRQL.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 2000.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe (режим ядра); Ntdll.dll (пользовательский режим)
IRQL <= APC_LEVEL (см. раздел "Примечания")

См. также раздел

RTL_BITMAP

RtlAreBitsClear

RtlFindClearBitsAndSet

RtlFindClearRuns

RtlFindFirstRunClear

RtlFindLastBackwardRunClear

RtlFindLongestRunClear

RtlFindNextForwardRunClear

RtlInitializeBitMap

RtlNumberOfClearBits

RtlSetAllBits