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

Статья
02/27/2024

Подпрограмма 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 (см. раздел "Примечания")