Функция RtlInitializeBitMap (wdm.h)
Подпрограмма 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 и более ранних версиях |