RtlInitializeBitMap 函数 (wdm.h)

项目
02/13/2024

RtlInitializeBitMap 例程初始化位图变量的标头。

语法

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

参数

[out] BitMapHeader

指向空 RTL_BITMAP 结构的指针。

[in] BitMapBuffer

指向位图本身调用方分配的内存的指针。此缓冲区的基址必须是 ULONG 对齐的。分配的缓冲区的大小必须是大小为 (ULONG) 字节的整数倍数。

[in] SizeOfBitMap

指定位图中的位数。此值可以是为位图分配的缓冲区中的任意位数。

返回值

无

备注

驱动程序可以使用位图变量作为跟踪一组可重用项的经济方式。例如，文件系统使用位图变量来跟踪磁盘上已分配哪些群集/扇区来保存文件数据。系统提供的 SCSI 端口驱动程序使用位图变量跟踪哪些队列标记已分配给 SCSI 请求块 (SRB) 。

必须在对位图变量执行操作的任何其他 RtlXxx 例程之前调用 RtlInitializeBitMap。 BitMapHeader 指针是所有后续 RtlXxx 调用中的输入参数，在 BitMapBuffer 上对调用方位图变量进行操作。调用方负责同步对位图变量的访问。

RtlInitializeBitMap 通过将调用方提供的 BitMapBuffer 和 SizeOfBitMap 值复制到其中来初始化调用方提供的RTL_BITMAP结构。随后，可以将结构传递给其他例程以操作位图。 RtlInitializeBitMap 不会修改位图的内容。

要求

要求	值
最低受支持的客户端	从 Windows 2000 开始可用。
目标平台	通用
标头	wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library	NtosKrnl.lib
DLL	NtosKrnl.exe (内核模式) ;Ntdll.dll (用户模式)
IRQL	如果 BitMapHeader 是内存驻留的，则为任何 IRQL; <= APC_LEVEL BitMapHeader 是否可分页或在 Windows 7 及更早版本上