Función RtlSetBits (wdm.h)

Artículo
02/27/2024

La rutina RtlSetBits establece todos los bits de un intervalo determinado de una variable de mapa de bits determinada.

Sintaxis

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

Parámetros

[in] BitMapHeader

Puntero a la estructura RTL_BITMAP que describe el mapa de bits. Esta estructura debe haber sido inicializada por la rutina RtlInitializeBitMap .

[in] StartingIndex

Especifica el inicio del intervalo de bits que se va a establecer. Se trata de un valor de base cero que indica la posición del primer bit del intervalo.

[in] NumberToSet

Especifica cuántos bits se van a establecer.

Valor devuelto

None

Observaciones

RtlSetBits simplemente devuelve el control si la entrada NumberToSet es cero. StartingIndex más NumberToSet debe ser menor o igual que BitMapHeader-SizeOfBitMap>.

Los autores de llamadas de RtlSetBits deben ejecutarse en IRQL <= APC_LEVEL si la memoria que contiene la variable de mapa de bits es paginable o la memoria de BitMapHeader es paginable. De lo contrario, se puede llamar a RtlSetBits en cualquier IRQL.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 2000.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuario)
IRQL	<= APC_LEVEL (consulte la sección Comentarios)