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

Статья
02/29/2024

Подпрограмма RtlInitializeBitMap инициализирует заголовок переменной растрового изображения.

Синтаксис

NTSYSAPI VOID RtlInitializeBitMap(
  [out] PRTL_BITMAP             BitMapHeader,
  [in]  __drv_aliasesMem PULONG BitMapBuffer,
  [in]  ULONG                   SizeOfBitMap
);

Параметры

[out] BitMapHeader

Указатель на пустую структуру RTL_BITMAP .

[in] BitMapBuffer

Указатель на память, выделенную вызывающим объектом, для самого растрового изображения. Базовый адрес этого буфера должен быть выровнен по ULONG. Размер выделенного буфера должен быть целым числом, кратным sizeof(ULONG) байтов.

[in] SizeOfBitMap

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

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

None

Remarks

Драйвер может использовать переменную растрового изображения в качестве экономичного способа отслеживания набора многократно используемых элементов. Например, файловые системы используют переменную растрового изображения для отслеживания кластеров или секторов на диске, которые уже были выделены для хранения файловых данных. Предоставленный системой драйвер порта SCSI использует переменную растрового изображения для отслеживания тегов очереди, назначенных блокам запросов SCSI (SRB).

RtlInitializeBitMap необходимо вызывать перед любой другой подпрограммой RtlXxx , которая работает с переменной растрового изображения. Указатель BitMapHeader является входным параметром во всех последующих вызовах RtlXxx , которые работают с переменной bitmap объекта в BitMapBuffer. Вызывающий объект отвечает за синхронизацию доступа к переменной растрового изображения.

RtlInitializeBitMap инициализирует предоставленную вызывающей RTL_BITMAP структуру, копируя в нее предоставленные вызывающим объектом значения BitMapBuffer и SizeOfBitMap . Впоследствии структура может быть передана другим подпрограммам для управления растровым изображением. RtlInitializeBitMap не изменяет содержимое растрового изображения.

Требования

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